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INTRODUCTION 


Welcome to the Dark Basic programming language, the most powerful BASIC language on the planet. Dark 
Basic requires no knowledge of programming, operating systems, previous creativity tools or utilities. All 
that is required from you is a good imagination and the desire to create your own software. The rest you 
can learn. 


Dark Basic allows you to create anything from a simple text program to a fast full screen 3D game. A single 
command can give you access to sound, music, animation, text and graphics with incredible ease. You can 
read and control peripheral devices such as force feedback joysticks and head mounted displays. The only 
thing between you and the creation of commercial quality software is time and talent. 


There are two schools of learning open to you. You may choose an academic route that details the various 
aspects of the BASIC language and prepares a foundation on which you can build. Alternatively, you may 
opt for the fast track that gives you a taste of programming in less than 15 minutes. 


Within this manual you'll also find reference to commands from the Enhacements Pack. At the time of 
writing, Enhancement commands can be bolted on to DarkBASIC buy purchasing the DarkMATTER Product. 
For more details visit the DarkMATTER web site at www.darkbasic.com/darkmatter 


PROGRAMMING PRINCIPALS 


The purpose of this section of the help is to teach you how to write your own DARK BASIC programs. BASIC 
is an acronym for Beginners All-purpose Symbolic Instruction Code. DARK derives from the term 'Dark 
Horse’ (go ahead, look it up). The traditional description of a program is a task that you want your computer 
to perform. The task is described to the computer using statements DARK BASIC can understand. 
Statements in your program must be written using a set of rules known as 'SYNTAX'. You must follow these 
rules if you are to write DARK BASIC programs. By proceeding through these sections in sequence, you will 
gain a firm understanding about the general rules of BASIC and how to apply them as a programmer. 

= Data Types, Variables and Arrays 

« Arithmetic, Relational and Boolean operators 

= Common Statements 

= Common and User Functions 


= Reserved Words, Remarks and Spacing 


« Errors and Warnings 


Data Types, Variables and Arrays 


DATA TYPES 


We have established that statements are used to write a program. A statement can be broken up into a 
command and its data. The command is the operation, or task you wish to perform. The data is that which 
must be used by the command to complete the operation. The data is also referred to as the parameter‘(s). 


There are three types of data you can use. Integer numbers, real numbers and string. Each type of data 
holds a slightly different type of value. 


Integer Numbers 

An integer number can hold a whole number, but no fraction. For the value to be negative, you must place 
a hyphen symbol (-) before the value. You must not use commas as part of the number as this would 
generate a 


SYNTAX Error. Examples of integer numbers: 


42 
10000 
-233000 
-100 


Real Numbers 
A real number can hold a whole number or a fractional number that uses a decimal point. For the value to 
be negative, you must place a hyphen symbol (-) before the value. Examples of real numbers: 


20.0005 
99.9 
-5000.12 
=9:999.°9:9:91. 


Strings 

String data is non-numerical, and is used to store characters and words. All strings consist of characters 
enclosed within double quotation marks. The string data can include numbers and other numerical symbols 
but will be treated as text. Examples of strings are: 


nan 
"Hello World" 
"Telephone" 

"T am 99 years old" 
WD i208 OS 6.07 68:6 ON 


Each string can consist of up to 255 characters. You can also have a string with no data whatsoever, 
represented by an empty pair of double quotation marks. 


VARIABLES 


The best way to demonstrate what a variable does is by way of an example. Take the calculation: 


A variable is used to store a value. It's that simple. You can have a variable that stores any type of data, 
and you can have as many as you want. The following program shows you how the contents of the variable 
can be output to the screen: 


A=3+4+4 


PRINT A 


Now take the next example to show you how variables can be used as freely as standard number types: 


yvowDp 


In the preceding example, 3 is stored in the A variable, 4 is stored in the B variable and C is given the result 
of the calculation between A and B. The calculation is based on the values stored within the variables and 
so the calculation is actually C = 2 + 8. The result, which in this case is 10, is stored as the new value of C 
and this is the value that eventually gets printed to the screen. 


So far, we have seen variables used to store and recall integer values. Variables can also store real numbers 
and strings. In order to allow a variable to store these other types of data, you must make sure the variable 
is recognized as an integer, real or string variable. To name a real number variable, you must add a hash 
character (#) as the last character of the variable name. If you want your variable to store a string, you 
must add a dollar character ($) as the last character of the variable name. Lets see these new variables 
used to store and recall real values: 


mydata#=42.5 
PRINT mydata# 


By adding the (#) symbol, we are instructing the program to treat the variable as a real number variable. 
Exactly the same rule applies to a string variable: 


mynameS$="Lee" 
PRINT myname$ 


All variable names can use either upper or lower case characters, which means a variable called NAME$ is 
the same variable as name$ or Name$. String variables even support the use of limited maths. The 
following example adds two strings together and the result is a concatenation of the two strings: 


aS="Hello" 
bS$="World" 
c$=a$+b$ 
print c$ 


To run this example, the text "HelloWorld" will be printed to the screen. Would you be able to alter this 
example to place a space between "Hello" and "World"? 


ARRAYS 


Arrays are going to be a very important part of your future programs. They allow you to store large 
amounts of data under a single name. You can then access the data by index rather than by name alone. 

If you had to write a program that stored each weeks lottery numbers, typing out 52 unique variable names 
is a lot of work, hard to maintain and quite unnecessary. Arrays allow you to create a special kind of 
variable that can store more than one item of data. You might start your program like this: 


lottery1$="43,76,12,34,12,11" 
lottery2$="76,12,34,12,11,44" 
lottery3$="12,34,12,02,05,07" 
etc.. 


Two hours later, you realize you could have written it like this: 


DIM lottery$ (52) 

lotteryS (1)="43,76,12,34,12,11" 
lotteryS (2)="76,12,34,12,11,44" 
lotteryS (3) ="12,34,12,02,05,07" 


(ulemee 


We declare a string array using the DIM command followed by a name for our array. Like variables, when 
we use a dollar symbol after the name we instruct the program to use the array to store only strings. We 
then enclose in brackets how many items of data we wish the array to store. The array can be filled almost 
like a variable, but you must also provide the position within the array you wish to store your data. 


But you then ask yourself what benefits I would have gained using the second approach. If you where also 
required to print out all 52 lottery numbers to the screen with your first approach you would have to add 
another 52 statements that printed each variable: 


PRINT lotteryl1$ 
PRINT lottery2$ 
PRINT lottery3$ 
etc.. 


But if you had used an array, the same example would look like this: 


PRINT lottery$ (1) 
PRINT lottery$ (2) 
PRINT lottery$ (3) 
etc.. 


You will have noticed that by using an array, you no longer have to refer to your data using a unique 
variable name. You can now point to the data you want using a position number. Accessing data this way 
has a thousand advantages over trying to access data by variable name alone, as you will discover. One 
example would be to improve the above like this: 


FOR T=1 TO 52 
PRINT lottery$ (T) 
NEXT T 


Incredibly the above code replaced 52 PRINT statements with just 3 statements. With the above example, T 
is incremented from 1 to 52 within a loop that prints out the contents of the array at that position. 


Arrays can also store multiple levels of data. At the moment our lottery entries are stored as strings and the 
numbers are hard to get at. Let's say we wanted to store all six numbers for every lottery week, we would 
create an array like this: 


DIM lottery (52,6) 


Without the dollar symbol($), we are declaring the array to store integer numbers instead of strings. You 
will also notice we have a second number separated by a comma. This means for every array position from 
1 to 52, there is a sub-set numbered 1 to 6 in which multiple data can be stored. You can visualize an array 
as a filing cabinet with large draws numbered 1 to 52. Within each of the 52 draws is a tray with 6 boxes 
inside. You can store a value in each box. In all you can store 312 (52 x 6) values in this array. You can 
have up to five dimensions in your array, which means you can create an array as big as (1,2,3,4,5). Be 
careful when declaring dimensions as large arrays consume large amounts of memory and may reduce 
overall performance of your program. 


Entering data into our new array is elementary: 


ottery(1,1)=43 
ottery(1,2)=76 
ottery(1,3)=12 
ottery (1,4) =34 
ottery(1,5)=12 
ottery(1,6)=11 
ottery (2,1) =43 
ottery(2,2)=76 
ottery(2,3)=12 
ottery (2,4) =34 


lottery (2,5)=12 
lottery (2,6)=11 


You are now able to give your program access to much more useful data. Unlike the string approach, you 
could make your program count how many times a certain number has appeared. 

As you have determined, arrays need to be declared as a particular type. You can have an array of integer 
numbers, real numbers or strings. You cannot have multiple types in the same array, but you can declare 
new arrays dedicated to holding such data. 


Arithmetic, Relational and Boolean 
Operators 


We have already used one type of well-known operator in the preceding examples. Operators are the term 
given to a mathematical symbol used in all calculations. The most common operators are arithmetic 
operators and are quickly identified. All operators require two operands of data that are placed either side of 
the operator. 


ARITHMETIC OPERATORS 


An arithmetic operator can represent an Addition, Subtraction, Multiplication or Division. These operators 
are represented symbolically as (+) (-) (*) (/) respectively. 

The Plus(+) sign specifies that the data on the right of the plus sign must be added to the data on the left. 
Examples of which you have already seen are: 


3 + 4 equals 7 

A + B equals the value of B added to the value of A 

The minus(-) sign specifies that the data to the right of the minus sign must be subtracted from the data to 
the left of the minus sign: 


3 - 4 equals -1 
A - B equals the value of B subtracted from the value of A 


An aster(*) specifies that the data on the right side of the aster is multiplied by the data on the left side if 
the aster: 


3 * 4 equals 12 
A * B equals the value of B multiplied by the value of A 


The slash(/) specifies that the data on the right side of the slash is to be divided by the data on the left side 
of the slash: 


10 / 2 equals 5 
A / B equals the value of B divided by the value of A 


RELATIONAL OPERATORS 


These operators are less common, unless you have programming experience. These operators represent 
conditions that are applied to data. The conditions handled are Equal To, Greater Than, Less Than, Greater 
or Equal To, Less or Equal To and Not Equal To. The purposes of these conditions are to determine the 
result of a comparison between two data values. A condition result can only be of two possible values. If the 
condition is false, the resulting value is zero. If the condition is true, the resulting value is one. Take the 
following examples: 


10 = 9 results in 0 because 10 is not the same as 9 
10 = 10 results in 1 because 10 is the same as 10 
10 > 9 results in 1 because 10 is greater than 9 


100 >= 100 results in 1 because 100 is greater or equal to 100 
The same relational operators can be applied to real numbers, integer and real variables and in some case 


strings and string variables. You can compare whether two strings are the same or not the same, but you 
cannot test whether one string is greater or less than another. 


BOOLEAN OPERATORS 


Simple Boolean operators provide the last type of operator. Although traditionally there are four types of 
Boolean operators, DARK BASIC only provides the AND and OR operators. These operators allow your 
program to perform logical operations on your data. 

The AND operator works with any integer value, but for demonstration purposes the general rule applies 
when using this operator: 


O AND 
O AND 
1 AND 
1 AND 


rPOrFO 
tow ow a 
rPoOoOOo 


What you see is the decision tree of the AND operator. It shows that only if both data operands of the AND 
operator are 1 will the result be a 1 also. All other cases a zero is returned. To see how this logic works in 
reality, take the following example: 


A=5 
B=25 
(A > 10) AND (B > 20) so what is the resulting value? 


We can determine the result of the parts enclosed in brackets first. We can see the relational operators 
provide us with the following results: 


(A > 10) results in 0 because 5 is not greater than 10 
(B > 20) results in 1 because 25 is greater than 20 


Our updated calculation looks something like this: 


(0) AND (1) results in 0 as our table shows 0 AND 1 = 0 


The logic of the table is that only when both sides of the AND operand are 1 will the result of the calculation 
be 1 also. What would happen if you change the value of A to 15? 


The OR operator works in a similar fashion, but using the following table. If either the left side or right has a 
value of 1, the result will be 1: 


0 OR 
0 OR 
1 OR 
1 OR 


FORO 
tow wou 
PRPRO 


You will discover how useful these operators become when writing conditions for your programs. Being able 
to write conditions with multiple parts will become increasingly important as you begin to write more 
complex programs. 


Common Statements 


ASSIGNMENT STATEMENTS 


You have already used an assignment statement, and is probably the most commonly used part of any 
programming language. The Equal Symbol (=) is used to assign a value to a variable or array. Take the 
following examples: 


a=42 

a#=99.9 
a$="HELLO" 
lottery (1,1)=49 


DATA AND READ STATEMENTS 


There are many occasions where you will be required to store data inside your program. Take our earlier 
lottery example. It would be much better to make a list of numbers at the end of the program simply add to 
the list as you get new lottery results. Using the DATA and READ commands you can do exactly that. Look 
at the following example: 


DATA 9,"NINE",9.9 
READ a,aS$,a# 


The DATA command accepts a list of data items separated by a comma. The data items do not have to be 
of the same type, but they do need to be read in the right type order. As you can see our first item of data 
is an integer number of 9, then a string with the text "NINE" and a real number with a value of 9.9. 


The READ command also accepts a list, but the list must contain variables that are of the correct type to 
read the data. When an item of data is read, a pointer moves to the next item of data stored in the list. The 
first item of data is an integer, which means the value of 9 is stored in the integer variable of A successfully. 
The data pointer then moves to the next item that is the string that stored "NINE" text. This is read and 
stored in the string variable A$. The same applies to the real number data of 9.9. 


If you where to visualize the data list in memory it would look like this: 


9 
"NINE" 
99 


If you tried to read the integer value of 9 into a string variable, an empty string will be stored as the types 
are incompatible. If you tried to read a string into an integer or real variable, a zero will be stored. It is your 
responsibility to make sure the type order used to store you data is the same when you come to read it 
back. 


RESTORE STATEMENTS 


You are able to reset the data pointer at any time using the RESTORE command. If for example you have 
read the data and printed it to the screen, you will need to read the same data again if the user wants to 
clear the screen and redraw the data. By resetting the data pointer the READ command will start at the top 
of the data list and you can read it again. 

You can also create more than one data list. If for example you required not only a data list of lottery 
numbers, you also required a list of lottery numbers on your lottery ticket then you will require two separate 
data lists. You create the data as follows: 


lotterydata: 
DATA 12,23,34,45,56,67 
DATA 23,34,45,56,67,11 
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DATA 34,45,56,67, 33,22 
ticketdata: 

DATA 01,02,03,04,05,06 
DATA 21,32,43,24,13,22 


To print the first set of data to the screen, you would first point the data pointer to the first set of data. You 
do this by using the RESTORE command and specifying the label that precedes the data statements. A label 
statement is declared by adding a colon (:) as the last character of the label. You can point the data as 
follows: 


RESTORE lotterydata 
READ a,b,c,d,e,f 
PRINT "LOTTERY ",a,b,c,d,e,f 


Then when you wish to print out the first ticket number from the second data list, you simply use the 
second label that points to the ticket data: 


RESTORE ticketdata 
READ a,b,c,d,e,f 
PRINT "TICKET ",a,b,c,d,e,f 


There are better ways to structure the reading of data from a data list, but these simple examples 
demonstrate how to access multiple lists of data. 


BRANCH STATEMENTS 


Normally, a program executes statements in sequence starting at the top. A branch statement allows you to 
jump to another part of the program to continue execution. A GOSUB command will jump to a label and 
continue from its new location. When the program encounters a RETURN command, the program will jump 
back to the GOSUB from where it originally came. Take the following example: 


PRINT "Hello" 
GOSUB MySubroutine 
END 

MySubroutine: 
PRINT "World" 
RETURN 


The program will print the "Hello" text to the screen, then jump to the MySubroutine line of the program 
and continue execution. The next commanzd it finds will print "World" to the screen. The RETURN command 
then returns the program to the point it left, where it then proceeds onto the next command after the 
GOSUB command which in this case is the END command. 


A GOTO command, however does not remember from where it jumped and will continue running from its 
new location permanently. It is not recommended you use GOTO commands often, as there are better ways 
to control the flow of your programs. Here is an example, however, of a simple GOTO command: 


MyLabel: 
PRINT "Hello World "; 
GOTO MyLabel 


Or alternatively: 


DO 
PRINT "Hello World "; 
LOOP 


You will agree the last example is a much better, cleaner and friendly way of doing the above and 
demonstrates how the use of GOTO can be eliminated. GOTO is retained in the DARK BASIC language for 
compatibility with older BASIC languages. 
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FOR NEXT Statements 


You may recall the user of the FOR NEXT statement in earlier examples. The FOR NEXT commands are used 
to create a finite loop in which a variable is incremented or decremented from a value to a value. A simple 
example would be: 


FOR T=1 TO 5 
PRINT Tp 
NEXT T 

PRINT "Done" 


The output to the screen would read: 


We 223.45 


The program would set T to a value of 1 and then go to the next line to PRINT. After the print, the NEXT 
command would return the program to the FOR command and increment the value of T to make it 2. When 
the PRINT command is used again, the value of T has changed and a new value is printed. This continues 
until T has gone from 1 through to 5, then the loop ends and the program is permitted to continue. The 
next command after the NEXT statement prints "Done" to the screen slowing the program has left the loop. 


You can also next loops to create a loop within a loop, as the following example shows: 


FOR A=1 TO 5 

PRINT "MAIN A=";A 
FOR B=1 TO 10 

PRINT "LITTLE B=";B 
NEXT B 

NEXT A 


The FOR NEXT statement loops the main A variable from 1 to 5, but for every loop of A the FOR NEXT 
statement inside the first loop must also loop its variable B from 1 to 10. This is known as a nested loop as 
the loop in the middle is nested inside an outer loop. 


Such loops are especially useful for working on array data by using the variables that increment as position 
indexes for the arrays. As an example, we could list all our lottery numbers using the following example: 


FOR week=1 TO 52 STEP 4 

PRINT "LOTTERY NUMBER FOR WEEK ";week; " ARE "; 
FOR index=1 to 6 

PRINT lottery (week, index);" "; 

NEXT index 

NEXT week 


Notice the new STEP command added to the end of the FOR NEXT statement. The STEP command is used 
to change the default increment value from 1 to another value. In this case, the program will only print the 
lottery numbers for every forth week. 


IF THEN Statements 


The IF statement allows your program to make decisions that controls the flow of your program. The IF 
statement requires an expression to evaluate that results in either true or false. If the expression is true, the 
commands following the THEN command will be executed. If the expression is false, the program will move 
onto the next statement and ignore the rest of the IF THEN statement. Take the following example: 


INPUT "Enter Your Age>",age 
IF age>=16 THEN PRINT "You can buy a lottery ticket" 
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When the user enters a value greater or equal to 16, the program will display its message. This program 
demonstrates a simple IF THEN Statement. To understand how this works we must look at the IF command 
in a little more detail. First, we must take the expression and evaluate it: 


age>=16 


We can determine from our earlier coverage of operators, that this relational operator will result in either a 
zero or a one depending on whether age is greater or equal to 16. The IF command considers a value of 
zero to be false and all other values as true. So we can determine that if age is indeed greater or equal to 
16 then the result will be 1, and the expression according to the IF command will be true. 


The expression can be any combination of values, variables, arrays and operators providing the expression 
makes sense. These expressions will make sense: 


IF A THEN PRINT "ok" 

IFA B THEN PRINT "ok" 

IFA (B - 5) THEN PRINT "ok" 

IF A = (B + (A * 2)) THEN PRINT "ok" 

IF A=1 AND B=2 THEN PRINT "ok" 

IF NAMES="FRED" AND SURNAMES="BLOGGS" THEN PRINT "ok" 
IF A#=1.5 OR LOTTERY (10,2)=20 THEN PRINT "ok" 


I Voi 


These expressions will not make sense: 


IF A = B = THEN PRINT "not ok" 
IF > A = B THEN PRINT "not ok" 
IF A B THEN PRINT "not ok" 

IF AND A THEN PRINT "not ok" 
IF B OR THEN PRINT "not ok" 


On occasions where one line is not enough after the THEN command, you can use the IF ENDIF statement. 
Using the same IF logic as above, instead of a THEN Command, simply provide your commands to executed 
on the lines following the IF command. You must then mark the end of the commands to be executed with 
an ENDIF command, as the following example shows: 


IF A=B 
PRINT "Hello A and B!" 
ENDIF 


This is the same as: 


IF A = B THEN PRINT "Hello A and B!" 


But the main advantage is that the first piece of code can be adapted to do this: 


IF A=B 

PRINT "Hello A!" 

PRINT "Hello B!" 

PRINT "Hello A and B!" 
PRINT "Hello B and A!" 
PRINT "Hello Everything!" 
ENDIF 


You can also respond to an IF command if the expression turns out to be false. In cases where you wish to 
execute a different piece of code if the condition is false, the ELSE command should be used as follows: 


IF A=B 

PRINT "The values are the same! 
ELSE 

PRINT "The values are different!" 
ENDIF 
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It is important to make sure that you always use an ENDIF when THEN is not in use. You will note ENDIF is 
used whether or not the ELSE command is utilized. 


PRINT Statements 


The PRINT command is capable of printing out more than a single value. The command allows you to 
specify a list of comma separated data. The data items can be of any type. Although the use of PRINT has 
been frequent in the above examples, there are some unique features you may not be aware of. When the 
PRINT command is used to print data to the screen, the print cursor that is used to paste the individual 
letters to the screen reset to the left of the screen and one line down when the print is complete. A string of 
PRINT commands will print to the screen one line at a time. You can change this by leaving the cursor at 
the end of the printed line after a PRINT command. You achieve this by adding a semi-colon (;) at the end 
of the print data, for example: 


PRINT "Hello "; 
PRINT "World" 


In the same way, you can use this symbol to separate data in the same PRINT command, for example: 


PRINT "My name is ";nameS, " and I am ";age;" years old." 


In addition to preventing the text cursor from resetting, you can also position the text cursor anywhere on 
the screen using the SET CURSOR command. This example will randomly print text anywhere on the screen: 


DO 

SET CURSOR RND (640) ,RND (480) 
PRINT "TEXT" 

LOOP 


There are much more sophisticated text commands in DARK BASIC that handle fonts, colors, sizes and 
styles but you may discover these as you explore the rest of the help system. 


INPUT Statements 


Though seldom used, the INPUT command is a very simple way of obtaining numeric and string input from 
the user. You can obtain a particular type of value simply by using a variable of that type, for example: 


INPUT aS 


Will accept a string input from the user. If they enter a number, it will be stored as a string in the variable 
A$. Your program can provide a prompt to make sense of the requested input, as follows: 


INPUT "What is your password? ",password$ 


This example prompts the user by printing the message to the screen and the user can enter the password. 
They will see their entry as they type it into the keyboard, and this entry will be stored in the string variable 
when they hit the return key. The same applies to integer and real variables. 


END and BREAK Statements 


The END command will terminate the execution of a program. If you where running the program from the 
editor, you will be dropped into the Command Line Interface (CLI). By using the END command, the user 
will not be able to continue running the program after they have terminated. If you where running the 
program as a standalone executable, the user will be returned to Windows. If the BREAK command was 
used in the program, execution will merely be suspended, and not terminated. BREAK commands are used 
to temporarily break out of a program and into the CLI for debugging purposes. You are able to continue 
running the program after a BREAK command has occurred. 
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Common and User Functions 


COMMON FUNCTIONS 


Functions can be described as commands that return a value. DARK BASIC uses arithmetic functions, string 
functions, command specific functions and user-defined functions. They all share commonalties that will 
help you recognize what they look like and how they are used. 


A simple arithmetic function is the ABS command, which takes a negative value and converts it to positive: 


PRINT ABS(-100) will print 100 as the result of the function 


The same function can be used in a calculation: 


A = B + ABS(-100) 


Or used with a variable: 


A = ABS( B ) 


Or used as part of a conditional expression: 


IF ABS( A ) > 180 THEN PRINT "ok" 


Just as you have become accustomed to using variables in place of standard numbers and strings, you can 
use functions in the same way. As shown, functions can take data but they don't have to. Some functions 
merely return a value, such as: 


DO 
PRINT TIMER () 
LOOP 


You will notice that even though no parameter data is required, you still need to add the brackets. The 
brackets instruct DARK BASIC it is a function and is a handy way of quickly determining whether it's a 
variable or function. Unlike variable and array names, functions only require a dollar symbol ($) if a string is 
to be returned. You do not need to specify a hash symbol (#) if the function is to return a real number, as 
the individual commands help will reveal. 


USER DEFINED FUNCTIONS 


There will come a time when the ability to create your own functions will be priceless. Experienced 
programmers would not be able to write effective code without them. Although GOSUB commands and 
subroutines have been provided for compatibility and learning, it is expected that you will progress to use 
functions as soon as possible. 


Functions are blocks of commands that usually perform a recursive or isolated task that is frequently used 
by your program. Variables and arrays used within the function are isolated from the rest of the program. If 
you use a variable name of FRED in your function, it will not affect another variable called FRED in your 
main program, nor any other function that happens to use a similar variable name. This may seem to be a 
restriction, but forces you to think about cutting up your program into exclusive tasks which is a very 
important lesson. 

You can pass up to 255 parameters into your function, and have the option of returning a value when the 
function returns. Functions that do not return a value can also be used as normal commands in your main 
program. 
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Declaring a function couldn't be simpler. Using the FUNCTION command, simply provide it with a name and 
a list of parameters in brackets and your declaration is half-complete. Enter the commands you want on the 
following lines and then end the function declaration with the command ENDFUNCTION. The following 
example declares a function that returns half of a value passed in: 


FUNCTION halfvalue (value) 
value=value/2 
ENDFUNCTION value 


This declaration creates a function that can be used as a better print command: 


REM Start of program 
BetterPrint(10, 10, "Hello world") 
END 

FUNCTION BetterPrint(x, y, t$) 

SET CURSOR x,y 

PRINT t$ 

ENDFUNCTION 
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Reserved Words, Remarks and Spacing 


RESERVED WORDS 


Words that are deemed to be reserved are the commands of the language. You will not be able to name 
your variables, arrays or user functions if they exist as part of the language as commands. As you become 
more familiar with the language, you will be able to naturally avoid using reserved words for your variable 
and array names. 


REMARKS 


You are able to write statements in your program that will be completely ignored when run. This may seem 
strange at first, but actually provides one of the most important features of your programming armoury. 
Remarks, also known as code commentary or documentation, are the plain English descriptions of what 
your program does at any point in the code. 


Although BASIC is quite concise as a readable language, it's never entirely clear what a piece of code is 
supposed to do if you read it for the first time. Do not be fooled into thinking the code you write yourself is 
for your eyes only. Returning to a piece of code you write 3 months previous will dispel any concerns you 
may have over the importance of remarks. 


The trick is to write only a summary of what a piece of code does. Leave out details, data and snippets that 
may change or be removed. Avoid typing a half-page description, as the likelihood is that you'll never find 
the time to read it. Remarks become a highly powerful part of your program if used correctly. 


You can use the REM command to make a comment, as follows: 


REM Print a greeting for the user 
PRINT "Hello World" 


There are other ways to make remarks in a program, such as the open quote symbol: 
~ Print a greeting for the user 
PRINT "Hello World" 


If you wish to 'comment out’ a number of lines in your program, you can avoid adding a REM command at 
the start of each line by using the following: 

REMSTART 

PRINT "Hello World" 

PRINT "Hello World" 


PRINT "Hello World" 
REMEND 


Anything between the REMSTART command and the REMEND command will be ignored when the program 


is run. These commands are especially useful for temporarily removing parts of the program for testing 
purposes. 


USE OF SPACING 


Unlike other BASIC languages, spaces are very important in your programs. It is important to separate 
commands and parameters; otherwise your program will not be understood. Take for example the line: 


FOR T=1 TO 10 


This would not be recognized if written as: 
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FORT=1T0O10 


Nor would this be easy to read either. Providing you use spaces to separate commands and parameters, you 
will encounter no problems with spacing. 
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Errors and Warnings 


There are many types of errors you will encounter while programming and running your creations, but they 
fall into four main categories: 


"SYNTAX ERROR' means you have tried to compile your program but a command statement was not 
recognized or understood. 


‘PARAMETER MISMATCH' means you have tried to compile your program but a known command has been 
given the wrong parameter data. You must provide the correct types of parameters for the command, and 
in the right order. 


‘RUNTIME WARNING' means the program has compiled and run successfully, but the command failed due 
to the reasons given with the warning. A warning will not be given in a standalone executable version of the 
program! 


‘RUNTIME ERROR' means the program has compiled and run successfully, but the command failed due to 


the reasons given with the error. An error will terminate a standalone executable version of the program 
and provide reasons for the error! 
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FAST TRACK LEARNING 


You want to create something now and learn the academics later on. The fast track will skip large chunks of 
ground work to get you using Dark Basic as quickly as possible. 


The fast track will let you accomplish five things: 
1) Execute your first command 

2) Create your first program 

3) Create your much better second program 

4) Build your first standalone executable 

5) Find and run your standalone executable 


You will be instructed what to do at every stage. You will be required to leave the help system from time to 
time, but you can always return using the Fil key. If you have misunderstood a lesson and need to return 
to an earlier stage, the BACK button at the top of the screen will step back through the pages. 


LESSON ONE: EXECUTING YOUR FIRST COMMAND 


You will already have noticed a number of buttons on the screen. Two large yellow buttons in the top right 
and a few smaller text buttons in the top left. This is as complicated as the Dark Basic editor gets. 


In order to execute a command on its own, you can make use of the Command Line Interface, or CLI for 
short. You can use the CLI to try out commands without having to write a program first. 
You will shortly be entering the CLI. When you are there, type the following: 


PRINT "Hello World" 


When you have typed out this line, hit the RETURN key. The RETURN key is used to execute the command 
line. The command itself prints 'Hello World' to the screen. You can enter the CLI by clicking the CLI button 
located at the top of the screen. You can then return to the help page by clicking the EXIT button located 
on the CLI bar. 


LESSON TWO: CREATING YOUR FIRST PROGRAM 


To create a program, you must write a sequence of commands in the editor. You can get to the editor from 
here very easily using the F11 key. You can return from the editor to the help page by pressing the F11 key 
again. You can use this key to bounce from editor to help, and vice versa. 


Go to the editor and type the following program: 


DO 
PRINT "Hello Again" 
LOOP 


You will shortly be running your program, but you must then be able to exit your program and return to the 
editor. At any time during the running of your program, you can press the F12 key to break from your 
program and return to the editor. 


From the editor, press the F5 key to compile and run your program. After a few second, press F12 to return 
to the editor. Alternatively, you can press F11 to return here. 


LESSON THREE: CREATING YOUR MUCH BETTER SECOND PROGRAM 
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It has taken you just a few minutes to write your first program. You are now a real programmer. You may 
be a programmer who only knows three commands, but a programmer nonetheless. Now you want to do 
something a little bit more impressive! 


We are going to create something that will impress your friends. Instead of spending the next 30 minutes 
writing out a lengthy program, we have provided CAVERUN.DBA available from the integrated help system. 


CSM SH SSSS SSeS SSeS eA 


PEM HERR Pee 
rem Author: DBS-LB99 

hide mouse 

rem Load bitmaps 

load bitmap "tiles.bmp",1 

get image 1,0,0,256,256 

delete bitmap 1 

rem Load sound 

load sound "hum.wav",1 

load sound "explode.wav",2 

set sound speed 1, 6000 

loop sound 1 

rem Load music track 

load music "caverun.mid",1 

loop music 1 

rem Activate manual sync 

sync on 

rem Make landscape and ceiling matrix 
make matrix 1,2000,5000,10,25 
prepare matrix texture 1,1,2,2 

make matrix 2,2000,5000,10,25 
prepare matrix texture 2,1,2,2 

fill matrix 2,0,2 

randomize matrix 2,350.0 

for t=0 to 25 

set matrix height 2,0,t,-100 

set matrix height 2,10,t,-100 

next t 

update matrix 2 

rem Bagin game loop 

do 

rem Set seed for same random numbers 
randomize 1 

rem Clear cave floor 

fii matrix. 1,0, 1 

rem Set lighting, fog and setupset ambient light 20 
fog distance 3000 

color backdrop 0 

fog color 0 

fog on 

rem Reset speed 

x=0 
z=0 
speed#=0.0 

rem Begin main loop 

repeat 

rem Record old variables 

oldx=x 

oldgy#=gy# 

rem Control key movements 

if upkey()=1 then speed#=speed#+1.0 else speed#=speed#-1.0 
if leftkey()=1 then rz#=rz#+1.0 

if rightkey()=1 then rz#=rz#-1.0 

rem Control variables 

if speed#>40.0 then speed#=40.0 

cz#=rz#t/1.1 

X=x- (2*rz#) 

rem Scroll landscape 

z=z+speed# 

if z>200 

zZ=z-200 
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if rnd(3)=0 
mp=mp-1 
mp=mp+rnd (3) 

if mp>4 then mp=4 


endif 

for t=0 to 0 : set matrix height 1,t,24,450 : set matrix tile 1,t,24,2 : next t 

for t=1 to mp : set matrix height 1,t,24,rnd(200) : set matrix tile 1,t,24,2 

next t 

for t=mp+1l to mp+l : set matrix height 1,t,24,rnd(200) : set matrix tile 

1,t,24,3 : next t 

for t=mp+2 to mp+3 : set matrix height 1,t,24,rnd(20) : set matrix tile 1,t,24,1 
next t 

for t=mp+4 to mp+4 : set matrix height 1,t,24,rnd(200) : set matrix tile 

1,t,24,4 : next t 

for t=mp+5 to 9 : set matrix height 1,t,24,rnd(200) : set matrix tile 1,t,24,2 

next t 

for t=10 to 10 : set matrix height 1,t,24,450 : next t 


update matrix 1 

shift matrix up 1 

shift matrix up 2 

endif 

rem Position matrix 

position matrix 1,0,0,2500-z 

position matrix 2,0,100,2500-z 

rem Position camera 

gy#=curvevalue (50+get ground height (1,500+x,z),gy#, 3) 
position camera 500+x,gy#,2500 

zrotate camera wrapvalue (rz#) 

rem Control sound frequency 

set sound speed 1, 6000+ (speed#*100) 

rem Update screen 

sync 

rem End main loop when collision with ceiling 
until get ground height (2,500+x,z)=gy#-75.0 
rem Return camera to point before collision 
position camera 500+oldx, oldgy#,2500 

rem Game Over 

play sound 2 

for c=0 to 255 step 20 

cls rgb(c,0,0) 

fog distance (c*5) 

fog color (c*256*256) 

sync 

next c 

rem End game loop 

loop 


LESSON FOUR: BUILD YOUR FIRST STANDALONE EXECUTABLE 


The programs you have created so far can only be run inside the Dark Basic editor. If you want to run them 
outside of Dark Basic you will need to build your program as a standalone executable. Not only are 
executables independent, they can also protect your source code and media files from being used 
separately. 


Media files are very important, especially in games. Media files are your bitmaps, sounds, music, animations, 
3d objects and data files that are used to make up the sounds and visuals of your program. 


There are two types of standalone executable. The first type does not save media files with your executable 
and the second type does. As our second program uses media files, we shall use the second type. 


If you go to the editor, your second program should still be listed. Press F7 to select the Build Final dialogue 
and click in the filename box to enter a name for your executable file. Click the BUILD button to build your 
executable file and then return to the help. 


LESSON FIVE: FIND AND RUN YOUR STANDALONE EXECUTABLE 
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For the most part, this means leaving the Dark Basic environment. If you are dealing with the world outside 
Dark Basic, it is important to know how to find and manage your executable files. How else will you be able 
to show off your programs? 


You will shortly be asked to exit Dark Basic to locate and find the executable you have built. The search 
should not be too difficult if you have remembered the name of your executable. All executable files are 
recognized by their .EXE extension. Dark Basic automatically appends this extension if not part of your 
filename. 


If you remember where you installed Dark Basic, you should find your executable file located in the DARK 
BASIC SOFTWARE\DARK BASIC\HELP\FAST\CAVERUN directory. Alternatively, you can go to START > FIND 
> FILES OR FOLDERS and enter the name of your executable. When you have located your executable, you 
can run it as normal. Either double click the file or use the right mouse button on the file and select Open. 
You can exit the program using the ESCAPE key. This completes your 15 minute lesson. 


To exit Dark Basic, simply click the EXIT button in the top right corner of the screen. 
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TUTORIALS 


TUTORIAL ONE: HELLO WORLD 


For our very first program, we want to get something happening as soon as possible. We will write a 
program that prints "hello world" to the screen over and over. 


Step 1 : How to PRINT to the screen 
You can print to the screen using the PRINT command, followed by what it is you wish to print. Lets first 
print something to the screen by typing the following into the editor: 


PRINT "Hello World" 


When you have typed this line into the editor, press F5 to compile and run the program. To go to the editor, 
click the EDIT button in the top left corner of the screen. When you have finished, you can return to this 
help page by pressing the F11 Key. 


Step 2 : How to repeat a command over and over 
Now we know how to print something to the screen, the next step is to make our program loop so that the 
PRINT command is called again and again. Modify your program so that it looks like this: 


DO 
PRINT "Hello World" 
LOOP 


The DO command and LOOP command mark the start and end of the loop for your program. When you run 
the program, it will continue to run inside this loop forever. You can quit the program at any time by hitting 
the ESCAPE key. 


Final Step : Things for you to change 

1. Change the words "Hello World" to anything you want, and see it repeated 
2. Place a semi-Colon(;) at the end of the print line to see what happens 

3. See the PRINT command help page for more ways to print 


TUTORIAL TWO: RANDOM PRINTER 


The purpose of this program is to scatter the printed text all over the screen in a random order, using a 
string entered by the user. 


Step 1 : Printing string variables 

If you read the PRINT command help page you will notice that many types of things can be printed to the 
screen, including string variables. You can use string variables to store letters, words and whole sentences 
in a single variable. Try typing the following and running the program: 


aS="Hello World" 
PRINT a$ 


You will notice the contents of the variable is printed. The principle would be the same for numbers too. 
Step 2 : Positioning the output 
It will often be the case that you wish to print the text at a certain point on the screen. This point would be 


called the coordinate and you would need to specify how far across and how far down the screen you would 
like the text to be placed. 
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The PRINT command always outputs at the current cursor position, and starts in the top left corner. You 
can set the position of the cursor using the SET CURSOR command. The command requires two parameters 
that indicate where you would like the new cursor position to be. The first value indicates the X coordinate 
that moves from left to right and the second value indicates the Y coordinate that moves from top to 
bottom: 


SET CURSOR 10,10 


When you place this line at the top of your program and run, you will see the text printed slightly offset 
from the top left corner of the screen. This is because you have specified 10 pixels across and 10 pixels 
down the screen for the cursor. It is worth noting that the cursor will advance to the next line and reset to 
the left side of the screen after a standard print command. 


Step 3 : Taking input from the user 


The contents of variables do not have to be decided as you write your program. You can use the INPUT 
command to accept values and strings into variables. The input command also uses the cursor to determine 
where on the screen it should show what the user is typing. Replace the line: a$="Hello World" with the 
following: 


INPUT "Enter Word>";a$ 


When you run the program, your user now has the ability to enter a string of their own. When return is 
pressed, the program continues onto the print command where their entry is printed to the screen. Notice 
where the cursor went after the input command was used. 


Step 4 : Random value generator 
In order to randomly place text on the screen, we need to generate a random coordinate for the cursor. We 
can do this using the RND command, which accepts a single range parameter. A line such as: 


PRINT RND(640) 


When run, this will print a random value between 0 and 640 to the screen. We will be able to use the same 
command to generate random X and Y coordinate values. 


Step 5 : The Main Loop 


Almost all large programs have a main loop. It can be pictured as an engine, with all it's cogs and gears 
revolving continually. It is often the first thing you will think about when writing your programs. 


Bring the above steps together and lessons learned from our first tutorial, write the following program: 


INPUT "Enter Word>";a$ 

DO 

CLS 

SET CURSOR RND(640), RND(480) 
PRINT a$ 

LOOP 


Final Step : Things for you to do 

1. Change the input command to prompt "What is your name?" 

2. Change the program so text only appears in the top half of the screen 
3. Change the program so the screen fills up with text 


TUTORIAL THREE: SCREEN SWITCHER 


The purpose of this program is to detect for the available screen display modes and let the user select which 
one they wish to use. The choice of display modes depends on the graphics card you have installed. 


25 


Step 1 : Detect all display modes available 

To make a list of available display modes, you must perform a check using the system checklist. Checklists 
are very easy to use and require a single command to fill the checklist with the data you require. For display 
modes, type the following command: 


PERFORM CHECKLIST FOR DISPLAY MODES 


The checklist will internally fill up with every display mode you can use on the current graphics card. 


Step 2 : Printing out the display mode data from the checklist 

The number of items stored in the checklist can be returned using the command CHECKLIST QUANTITY(). A 
description of the display mode can be returned using the command CHECKLIST STRING$(index), where 
index is the position in the list you are interested in. We can set up a FOR NEXT loop that scans the entire 
list, and prints out the description. Notice how the value of T can be included in the line to be printed: 


CLS 

FOR T=1 TO CHECKLIST QUANTITY () 
PRINT T;" ";CHECKLIST STRINGS (T) 
NEXT T 


If you were to run the program now, you will see a list of display modes printed alongside it's position in the 
list. We will want our program allow the user to select a display mode from this list. For convenience, we 
will only allow display modes 1-9 from being selected. 


Step 3 : Selecting a display mode from 1 to 9 

When the user has selected a number, we want to set the display mode to the same as that described in 
the list. The description of a display mode is Width, Height and Bit-Depth. These values are also stored 
separately in the checklist for us to use. Add the following code: 


DO 
IF ASC (INKEYS ())>48 
position=ASC (INKEYS())-48 


width=CHECKLIST VALUE A(position) 
height=CHECKLIST VALUE B (position) 
depth=CHECKLIST VALUE C (position) 

SET DISPLAY MODE width, height, depth 
ENDIF 

LOOP 


When you run the program, you should be able to select from a list of display modes and switch to that 
resolution. You will notice the screen is cleared. This is a very important fact. When the screen resolution is 
changed, all video memory is wiped which includes screens and textures. 


Step 4 : Restoring the screen 
It is a simple matter to restore the screen after a screen switch. Simply move the DO command from the 
middle of your program to the top. Your main loop is now complete. 


Final Step : Things for you to do 

1. Change the program to only list 9 display modes 

2. Change the program to allow the user to select up to 99 display modes 
3. Change the program so 8-bit depth display modes cannot be selected 


TUTORIAL FOUR: ARTISTIC VARIABLES 


The purpose of this program is to demonstrate how variables can be used to draw simple shapes on the 
screen. It also demonstrates how to draw a circle using nothing but dots. 
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Step 1 : Drawing basic shapes 

Drawing simple shapes to the screen is very straight forward. Providing you know that an X coordinate 
measures the horizontal distance of the screen from left to right and that the Y coordinate measures the 
vertical distance of the screen from the top to the bottom, you should be able to understand what each of 
these do: 


CLS 

DOT 635,475 

BOX 10,10, 630,20 

CIRCLE 320,240,100 
ELLIPSE 320,240,100,200 
LINE 120,240,520,240 


Step 2 : A touch of color 

If you run the program now, you will notice they are all the same color. White on black is the default color 
scheme, but you can change this to anything you wish. To draw in a particular color, you must set the ink 
color first. In order to set the ink color you need a special color value. As the color value is made up of red, 
green and blue components, it is very difficult to find the right value be guesswork alone. It is for this 
reason that the RGB command was created. This command takes a red, green and blue value separately 
and produces a single value that represents the desired color to set the ink with. The ink command itself 
requires two color values. The first is a foreground color that paints the shapes whereas the second is a 
background color that is used to clear the screen with. Place this line at the top of your code to see what 
happens: 


INK RGB(255,100,0),RGB(0,0,255) 


Step 3 : Using variables to draw 

The idea of using variables to draw to the screen is a profound lesson to learn. It is the basis on which all 
advanced computer graphics are based. To draw a thing, move its position value and draw it again is the 
very essence of movement. To draw a thing, change the image value and draw it again is the very essence 
of animation. Prepare to type your first profound piece of code: 


v=0 

DO 

LINE 0,v,v,480 
vevt1 

LOOP 


It may not seem profound now, but you will repeat this basic logic thousands of times. Learning its 
importance now will advance your learning considerably. Run the program to see what happens. 


Step 4: From a line to a circle 
It's not just strange line patterns that can be created. Replace the code segment above with the following 
lines to see how variables can command even more control over what you draw: 


v=0 

cx=160 

cy=120 

DO 
ox=cos (v) *100 
oy=sin(v) *100 
vevtl1 

DOT cx+ox,cytoy 
LOOP 


Final Step : Things for you to do 

1. Change the program to alter the size of the dot circle 

2. Change the program to alter the color of the dots within the circle 

3. Change the program to move the center of dot circle as it's being drawn 
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TUTORIAL FIVE: STOCK MARKET ARRAYS 


The purpose of this program is to demonstrate the use of arrays to read and write data in an organized 
manner. When programs reach a certain size, the storage and organized retrieval of data is very important. 
When you lose control of your data, you lose control of your program. 


Step 1 : Creating the stock market database 

In order to store large amounts of data, you must first create an array to store it in. Arrays can be thought 
of a vaults of data, with a box for each piece of data. You can have as many boxes as you want, and each 
box can have its own set of boxes. As an example, we shall write a program that controls the stock of five 
companies. Each company requires a stock price and a stock quantity. We will need at least 5 boxes, and in 
each box we will need a place to store 2 pieces of data: 


DIM companies (5,2) 


Step 2 : Filling the database 


We must fill the array with data before we can start trading: 


companies (1,1)=90 : companies (1,2) =200 
companies (2,1)=70 : companies (2,2) =1000 
companies (3,1)=60 : companies (3,2) =2000 
companies (4,1)=20 : companies (4,2)=1500 
companies (5,1)=15 : companies (5,2) =300 


Step 3 : Reading the database 

Once we have stored this data, we are able to read it back a number of ways. The most common way is to 
use a variable that holds the value of the company we are interested in. We can print out the data for all 
five companies using a variable. Add these lines of code: 


CLS 

FOR c=1 TO 5 

PRINT "#";c;" Price ";companies(c,1);" Quantity ";companies (c, 2) 
NEXT c 


This demonstrates the practicality of using arrays. You are able to store data values that belong together, 
and by changing the index variable, you can jump to new records with the same pattern of data. This 
understanding will allow you to organize your data to make your programs easier to read and manipulate. 


Step 4 : Writing to the database 

Writing to the array is the same as before. The only difference in the following lines of code is the use of an 
index variable instead of a numerical value. The following code will ask the user to enter a company number 
and a new price and quantity value: 


INPUT "Enter a company number (1-5) >"; index 
PRINT "Company #";index;" Change Request" 
INPUT "Enter new Price>";price 

INPUT "Enter new Quantity>; quantity 
companies (index,1)=price 
companies (index, 2) =quantity 


You can view the results of this change by making your program loop back to the top and printing out the 
companies list again. Can you figure out how to use the DO and LOOP commands to accomplish this? 


Final Step : Things for you to do 

1. Change the program to loop and EXIT when the user enters zero for company number 
2. Change the program randomly change the stock price in each company every cycle 

3. Change the program to list the worth of each company (price * quantity) 
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TUTORIAL SIX: PHOTOCOPIER 


The purpose of this program is to demonstrate how to load a bitmap onto the screen and manipulate the 
image. The program loads the picture then grabs four equal segments from it, storing the images in 
memory. The images are then pasted back onto the screen clockwise. By repeating this action, the 
segments will appear to be rotating around the screen in a clockwise direction. 


rem Load a bitmap onto the screen 
LOAD BITMAP "sample.bmp" 

rem Begin loop 

DO 

rem Grab all four quarters of the screen 
GET IMAGE 1,0,0,320,240 

GET IMAGE 2,320,0,640,240 

GET IMAGE 3,320,240, 640,480 

GET IMAGE 4,0,240, 320,480 

rem Paste in their neighbors quarter 
PASTE IMAGE 1,320,0 

PASTE IMAGE 2,320,240 

PASTE IMAGE 3,0,240 

PASTE IMAGE 4,0,0 

rem Small delay 

SLEEP 100 

rem End loop 

LOOP 


The LOAD BITMAP command takes the filename of a media file in the BMP file format. The media file has to 
be in the same directory as the program. When the GET IMAGE command is used, it copies the specified 
area from the screen and stores it in memory. This image can then be pasted to any location. The SLEEP 
command works in units of 1000 per second, and is used to momentarily pause the program. 


Final Step : Things for you to do 

1. Change the program to slow down the rate of clockwise rotation 

2. Change the program to make the segments rotate anti-clockwise 

3. Change the program to divide the picture up into smaller tiles when rotating 


TUTORIAL SEVEN: SOUND AND MUSIC 


The purpose of this program is to demonstrate how to load sound and music files and play them. 
Additionally, the program shows you how to detect for physical keyboard strikes using the SCANCODE 
command and provides some audio insight into how Dark Basic handles multi-channel sound. 


This tutorial program can be loaded directly into the editor by clicking SAMPLEO7.DBA. 


rem Load music file 

LOAD MUSIC "sample.mid",1 

rem Load sound file 

LOAD SOUND "sample.wav",1 

LOAD SOUND "sample.wav",2 

LOAD SOUND "sample.wav",3 

rem Start Music 

LOOP MUSIC 1 

rem Begin loop 

DO 

rem Pressing key '1' will play sound 1 

F SCANCODE()=2 AND SOUND PLAYING(1)=0 THEN PLAY SOUND 1 
rem Pressing key '2' will play sound 2 

F SCANCODE()=3 AND SOUND PLAYING(2)=0 THEN PLAY SOUND 2 
rem Pressing key '3' will play sound 3 

F SCANCODE()=4 AND SOUND PLAYING(3)=0 THEN PLAY SOUND 3 
rem End loop 

LOOP 
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The LOAD MUSIC command takes a file in the MIDI format, and loads it into music number 1. Many music 
files can be loaded, but only one score of music can be played at any one time. The LOAD SOUND 
commands load the same WAV format sound file into sound numbers 1, 2 and 3. The reason for this is to 
provide multi-channel sound in the program, which allows the sounds to overlap each other for best effect. 
The LOOP MUSIC command plays the music and instructs it to repeat continuously. The SCANCODE() 
command returns the value of the key currently being pressed. The SOUND PLAYING() command returns a 
1 when the sound is playing, and zero at all other times. 


Final Step : Things for you to do 

1. Change the program to stop the music if a sound is played 

2. Change the program to play the music if the 'm' key is pressed 

3. Change the program to increase the number of explosions from 3 to 5 


TUTORIAL EIGHT: WALKING SPRITE 


The purpose of this program is to demonstrate how to take a bitmap animation sequence and extract the 
images to provide a sprite with animation. The sprite will automatically run across the screen, using the 
animation sequence extracted from the bitmap. 


rem Load character into hidden bitmap 

LOAD BITMAP "runner.bmp",1 

rem Grab images for character animation 

FOR y=0 to 1 

FOR x=0 TO 6 

GET IMAGE 1+x+(y*7), (x*89), (y*120), (x*89) +89, (y*120) +120 
NEXT x 
NEXT y 
rem Delete character bitmap 

DELETE BITMAP 1 

rem Set player variables 

xpos=0 

ypos=300 

image=1 

rem Activate manual syncronization 

SYNC ON 

rem Begin Loop 

DO 

rem Run right and wrap 

xpos=xpos+6 : IF xpos>640 THEN xpos=-64 
Rem Animate runner and wrap 
image=imaget+tl : IF image>12 THEN image=2 
rem Update sprite 

sprite 1,xpos, ypos, image 

rem Refresh screen now 

SYNC : SLEEP 20 

rem End Loop 

LOOP 


The first part of the program loads the bitmap animation sequence into bitmap 1. Bitmap numbers 1 
through 32 are off screen bitmaps and are not visible. A bitmap animation sequence is a normal bitmap file 
with a grid of single images side by side that provide the effect of animation when displayed in sequence. A 
FOR NEXT loop is used to extract images from the bitmap. The bitmap is then deleted as the images are 
now safely stored in memory. 

The second part of the program sets values to our variables and prepares to enter the main loop. The SYNC 
ON command informs the system that the program will take responsibility for refreshing the screen. We do 
this to ensure the screen refresh rate is smooth and controlled. Leaving this out would cause the program to 
run so fast you would hardly see the sprite at all! 

The main loop begins with the increment of two variables. Both are given maximum values, beyond which 
the variable will wrap around. The sprite command displays sprite 1 at the latest coordinate and image 
value. The XPOS variable makes sure the sprite is continually moving across the screen. The IMAGE variable 
keeps changing the image value to make the sprite animate from frame to frame. 
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The last part of the loop synchronizes the refresh of the screen and forces a small delay to prevent the 
sprite from moving too fast. 


Final Step : Things for you to do 

1. Change the program to position the character nearer the top of the screen 

2. Change the program to make the sprite move faster 

3. Change the program to make the animation slower without slowing down movement 


TUTORIAL NINE: TERRA FORM 


The purpose of this program is to demonstrate how you can create a vast landscape with very few 
commands. This program also demonstrates fogging and camera control. 


rem Load stone floor bitmap into image 
LOAD BITMAP "floor.bmp",1 

GET IMAGE 1,0,0,128,128 

DELETE BITMAP 
rem Activate manual syncronization and hide mouse 
SYNC ON : HIDE MOUSE 

rem Make a 3D landscape 

MAKE MATRIX 1,10000.0,10000.0,25,25 

rem Texture landscape 

PREPARE MATRIX TEXTURE 1,1,1,1 

rem Randomise landscape 

RANDOMIZE MATRIX 1,300.0 

rem Activate and distance fogging 

FOG ON 

FOG COLOR 0 

FOG DISTANCE 5000 

rem Begin loop 

DO 
rem Control camera turret 

IF LEFTKEY()=1 THEN angle#=angle#-3.0 
IF RIGHTKEY()=1 THEN angle#=angle#+3.0 
rem Ensure angle stays within range 
angle#=wrapvalue (angle#) 

rem Update camera 

YROTATE CAMERA angle# 

rem Refresh screen 

SYNC 
rem End loop 
LOOP 


The first part of the program loads a bitmap off screen and grabs the contents as an image. This image will 
later be used to texture the landscape. To create the landscape, a matrix is used. A matrix is a collection of 
grid squares that can be raised, lowered and textured at your command. The program creates a matrix ten 
thousands square units in size, subdivided into 625 separate squares(25x25). The matrix is then textured 
and randomized to create the effect of stone hills. 


If your graphics card supports such a feature, fogging is activated and the distance is set to the clipping 
range of the system. Dark blue is applied as the fog color and is later used to clear the screen. 


A special real number is used for the camera angle value, indicated by the hash(#) appended to the 
variable. The left and right arrow keys alter the value of the angle variable and later code ensures the angle 
variable wraps around when either the maximum or minimum value is exceeded. 


The last part of the main loop updates the angle of the camera using the ROTATE CAMERA command. In 
order to maintain a steady speed, the program uses SYNC to refresh the screen. 


Final Step : Things for you to do 
1. Change the program to make the camera rotate faster 
2. Change the program to make the color of the sky turn red 
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3. Change the program to Randomize the matrix when a key is pressed 


TUTORIAL TEN: 3D THAT WALKS 


The purpose of this program is to demonstrate how you can load a fully textured, animating 3D character 
and walk it around the screen. This program shows you how to position the camera, append animation 
data, position, rotate and animate your 3D objects. The program also contains code that shows you how to 
use and calculate variables responsible for positioning and moving your objects in 3D space. 


rem Position camera off center 

POSITION CAMERA 0.0,0.0,-1000.0 

rem Load 3D object and append walking data to it 
LOAD OBJECT "idle.x",1 : APPEND OBJECT "walk.x",1,100 
YROTATE OBJECT 1,180 : FIX OBJECT PIVOT 1 

rem Loop 3D object animation from 0 to 20 (idle) 

LOOP OBJECT 1,0,20 : SET OBJECT SPEED 1,10 

rem Activate manual syncronization 


SYNC ON 
rem Begin loop 
DO 
rem Modify character angle based on left/right keys 
stage=0 
F LEFTKEY()=1 THEN a#=a#-8.0 
F RIGHTKEY()=1 THEN a#=a#+8.0 


a#=wrapvalue (a#) 
rem Modify character position based on up/down keys 


F UPKEY()=1 THEN x#=NEWXVALUE (x#,a#,3) : Z#=NEWZVALUE (z#,a#,3) : stage=1 

F DOWNKEY()=1 THEN x#=NEWXVALUE (x#,a#,-3) : z#=NEWZVALUE (z#,a#,-3) : stage=1 
rem If character action changes 

F stage<>oldstage 

F stage=0 


n 


ET OBJECT FRAME 1,0.0 
LOOP OBJECT 1,0,20 

SET OBJECT SPEED 1,10 
ENDIF 


stage=1 

SET OBJECT FRAME 1,105.0 
LOOP OBJECT 1,105,125 
SET OBJECT SPEED 1, 40 
ENDIF 
oldstage=stage 
ENDIF 
rem Update character position and angle 
POSITION OBJECT 1,x#,0.0,z# 

YROTATE OBJECT 1,a# 

rem Refresh screen 

SYNC 
rem End loop 
LOOP 


You will have noticed how useful the REM statements have become since tutorial six. Documenting a 
program not only explains what your code does, but allows you to break up your program into meaningful 
tasks. In addition to the information provided by the commentary, Dark Basic offers you the ability to 
request information on the command itself. Simply go to the editor that lists your program, click on a 
command you would like to know more about and then hit F1. This feature is called context sensitive help 
and you will be taken directly to a help page that fully describes the command and explains how to use it. 
Additionally, each help page has its own example program and references to the glossary or other related 
commands. 


Final Step : Things for you to do 

1. Change the program to make the character walk faster 

2. Change the program to create a landscape for the character to walk on 
3. Change the program to make the camera always point to the character 
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If you have completed all ten tutorials, by successfully making the changes listed in the Final Step segment 
at the end of each tutorial, you have done extremely well. Don't worry if you haven't understood all the 
tutorial samples. It takes time to completely grasp the fundamentals, especially in the early stages of 
learning. If this is the case, it is advised that you return to the last tutorial you were comfortable with and 
adapt it by making your own changes. When you are practiced at making changes to that tutorial, you 
should be able to proceed to the next one with some confidence. 
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DarkBASIC REFERENCE 
Basic Command Set 


All BASIC languages are formed from a core set of commands that make learning a new language a gradual 
and rewarding process. Not only are these commands essential for the beginner, but are a vital building 
block for all programs. All standard structures, conditional operators and mathematical forms are 
recognized. 


IF THEN 
This command will allow your program to perform a sequences of commands based on the result of a 
condition. If the condition is true, the commands after the THEN keyword are performed. Ensure that your 
commands after the THEN keyword are separated by a colon(:). If the condition is false, the rest of the line 
is skipped. 


SYNTAX: 


IF Condition THEN Command Go Here for condition True 


IF ENDIF 

This command will allow your program to perform a sequences of commands based on the result of a 
condition. If the condition is true, the commands immediately following the IF command are performed. If 
the condition is false, all commands before the ENDIF command are skipped. 


SYNTAX: 
IF Condition 
Command Go Here for condition True 
ENDIF 


IF ELSE ENDIF 

This command will allow your program to perform two different sequences of commands based on the 
result of a condition. If the condition is true, the commands immediately following the IF command are 
performed. If the condition is false, the commands immediately following the ELSE command are 
performed. You must always use an ENDIF to mark the end of the ELSE command sequence. 


SYNTAX: 
IF Condition 
Command Go Here for condition True 
ELSE 
Command Go Here for condition False 
ENDIF 


FOR NEXT 

This command will define a program loop that will loop a finite number of times. The FOR command 
requires a variable and two values to begin the loop. The variables stores the first value, and is incremented 
by 1 each loop until it reaches the second value. The NEXT command is placed to mark the end of the loop. 
As the variable increments during the loop, you can use its value in many ways. You can increase the size of 
this increment by using the STEP command. 


SYNTAX: 
FOR Variable = valuel TO value2 
Commands Go Here 
NEXT Variable 


STEP 
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This command will define a program loop that will loop a finite number of times. The FOR command 
requires a variable and two values to begin the loop. The variables stores the first value, and is incremented 
each loop until it reaches the second value. The size of the increment is determined by the STEP value. The 
NEXT command is placed to mark the end of the loop. As the variable increments during the loop, you can 
use its value in many ways. Optionally, you can count in descending order by specifying a high first number, 
a low second number and a negative step value. 


SYNTAX: 
FOR Variable = valuel TO value2 STEP increment-value 
Commands Go Here 
NEXT Variable 


DO LOOP 
These commands will define a loop that will repeat indefinitely. You are able to break from the loop at any 
time by using the EXIT command. 


SYNTAX: 
DO 
Commands Go Here 
LOOP 


REPEAT UNTIL 

These commands will define a loop that will repeat until the Condition becomes true. Unlike the WHILE 
command, the repeat loop allows the command sequence within your loop to run at least once before the 
Condition is checked. You are able to break from the loop at any time by using the EXIT command. 


SYNTAX: 
REPEAT 
Commands Go Here 
UNTIL Condition 


WHILE ENDWHILE 

These commands will define a loop that will repeat while the Condition is true. Unlike the REPEAT 
command, the while command ensures the Condition is true before entering the loop. You are able to break 
from the loop at any time by using the EXIT command. 


SYNTAX: 
WHILE Condition 
Commands Go Here 
ENDWHILE 


EXIT 

This command allows you to break from a program loop at any time. Only control loops that have an 
uncertain exit condition can use this command such as DO LOOP, WHILE and REPEAT loops. EXIT will have 
no effect on FOR NEXT and GOTO loops during the running of your program. 


SYNTAX: 
EXIT 


FUNCTION 

These commands will declare a user defined function within your program. User functions work in the same 
way normal commands work. They can accept multiple parameters and return values in the same manner, 
allowing you to create customized commands within your program. 


You will need to specify a name for your function, which must not be a reserved word and must not contain 
spaces or invalid characters. The parameter list for the function must then be specified within brackets. Do 
not leave a space between the function name and the brackets.. Your parameter list can be left empty, or 
you can specify up to 255 parameter names inside the brackets. A parameter is declared by simply entering 
a name. If you require more than one parameter, make sure you use commas to separate them. You may 
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enter commands for your function starting on the line following the declaration. You must declare the end of 
a function using the ENDFUNCTION command. If you wish your function to return a value, simply add the 
variable or value after the ENDFUNCTION command. You must leave a space between the endfunction 
command and the variable or value you wish to return. 


Any variables declared in the function are what are known as local variables. Local variables can only be 
recognized and used from within the function. Global variables on the other hand are variables declared 
outside of any function. Your function cannot recognize or use global variables. Your program cannot 
recognize or use local variables if you are running outside of the function in question. This allows you to re- 
use variable names within a function without fear of overwriting some other global variable elsewhere in 
your program, amongst other advantages. The same rules apply to arrays and parameters passed into the 
function. Parameters declared by the function can be used in the same way you would use any local 
variable, in order to bring information from the outside world. 


SYNTAX: 
FUNCTION Name (Parameter List) 
Commands Go Here 
ENDFUNCTION Return Value 


ENDFUNCTION 
See Above. 


EXITFUNCTION 
This command will immediately exit the current function, optionally returning a value. The remaining code 
between the EXITFUNCTION and the ENDFUNCTION commands will be ignored. 


SYNTAX: 
EXITFUNCTION 
EXITFUNCTION Return Value 


GOSUB 

This command will jump to the specified label in the program. Unlike the GOTO command, you can use the 
RETURN command to return to the program location of the last jump performed. In order to use the GOSUB 
command you must create a subroutine in your program that terminates with the RETURN command. To 
create a subroutine you must write a label in your program followed by a sequence of commands. The label 
can be made up from any combination of alphabetic characters, but you must end the declaration of the 
label using a colon(:). You only need to use a colon when you are declaring the label, and should not be 
used when calling the label from a GOSUB command. 


SYNTAX: 
GOSUB Label 
Label: 
Commands Go Here 
RETURN 


GOTO 

This command will jump to the specified label in the program. Unlike the GOSUB command, you cannot 
return from a call when using the GOTO command. The label can be made up from any combination of 
alphabetic characters, but you must end the declaration of the label using a colon(:). You only need to use a 
colon when you are declaring the label, and should not be used when calling the label from a GOTO 
command. 


SYNTAX: 
GOTO Label 
Label: 
Commands Go Here 


END 
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This command will stop the program running. If your program was run from the editor, you will be taken to 
the CLI.. If your program was executed as a standalone executable, you will exit your program and return 
to Windows. 


SYNTAX: 
END 


SELECT 

Use this command in combination with CASE, ENDCASE and ENDSELECT to create a select statement. A 
select statement allows you to branch to different actions based on the value of the provided variable. The 
variable can be an integer, real or string value. 


SYNTAX: 
SELECT Variable 


CASE 
Use this command in combination with SELECT, ENDCASE and ENDSELECT to create a select statement. A 
case statement specifies the value that if matching the contents of the variable, will run the code below it. 


SYNTAX: 
CASE Value 


CASE DEFAULT 

Use this command in combination with SELECT, ENDCASE and ENDSELECT to create a select statement. A 
case default statement holds code below it in the event that no case statement catches the value of the 
variable. The case default statement must go at the end of a sequence of case statement, but above the 
ENDSELECT statement. 


SYNTAX: 
CASE DEFAULT 


ENDCASE 
Use this command in combination with SELECT, CASE and ENDSELECT to create a select statement. A 
caseend statement specifies the end of a piece of code you are specifying for a case statement. 


SYNTAX: 
ENDCASE 


ENDSELECT 
Use this command in combination with SELECT, CASE and ENDCASE to create a select statement. An 
endselect statement specifies the end of a select statement. 


SYNTAX: 
ENDSELECT 


Example 1 Using a Number 
Variable=2 
select Variable 


case 0 : center text 320,0,"IT IS 0" : endcase 

case 1 : center text 320,0,"IT IS 1" : endcase 

case 2 : center text 320,0,"IT IS 2" : endcase 

case 3 : center text 320,0,"IT IS 3" : endcase 

case 4 : center text 320,0,"IT IS 4" : endcase 

case default : center text 320,0,"NOT IN RANGE" : endcase 
endselect 


Example 2 Using a string 
VariableS="MALCOLM" 
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select Variables 


case "JOHN" : center text 320,0,"HI JOHN" : endcase 
case "LEE": center text 320,0,"HI LEE" : endcase 
case "CHRIS" : center text 320,0,"HI CHRIS" : endcase 
case "MALCOLM" : center text 320,0,"HI MALCOLM" : endcase 
case "JAMES" : center text 320,0,"HI JAMES" : endcase 
case default : center text 320,0,"BIG HEAD BOB" : endcase 
endselect 
RESTORE 


This command will reset the DATA statement pointer to the very first piece of data in your program. 
Optionally, if you specify a label, it will reset to the DATA statement immediately following that label. To 
create a DATA statement label you must write a label in your program followed by a sequence of DATA 
commands. The label can be made up from any combination of alphabetic characters, but you must end the 
declaration of the label using a colon(:). You only need to use a colon when you are declaring the label, and 
a colon should not be used when calling the RESTORE command. 


SYNTAX: 
RESTORE 
RESTORE label 


DATA 

This command allows you to create a sequence of data values as part of your program. The values can be 
integer, real or string values. You may place the data values in any order you wish providing you separate 
each one with a comma or place new data values in a separate DATA statement. Data values can be read 
from the DATA statement using the READ command, and the point at which the data is read can be reset 
using the RESTORE command. You can separate batches of DATA statements using labels in order to 
segment your data for alternative uses. 


SYNTAX: 
DATA Datalist 


READ 

This command will read next available item from the DATA statement in your program and place the 
resulting data in a specified variable. You can create DATA statements using the DATA command, and you 
can reset the pointer to the data using the RESTORE command. You can read the data as integer numbers, 
real numbers or strings but you must ensure the DATA statements data types are in the same order as your 
program reads them. If you read data into a variable of the wrong type, a zero value or empty string is 
written into the variable. 


SYNTAX: 
READ Variable 
READ Variable# 
READ Variables 


SUSPEND FOR KEY 
This command will pause the program from running until a key is pressed. To detect for a specific key, 
please refer to the INKEY$ or SCANCODE commands found in the Input Command Set. 


SYNTAX: 
SUSPEND FOR KEY 


SUSPEND FOR MOUSE 
This command will pause the program from running until a mouse button is pressed. To detect for a specific 
mouse button, please refer to the MOUSECLICK() command. 


SYNTAX: 
SUSPEND FOR MOUSE 
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WAIT KEY 
This command will pause the program from running until a key is pressed. To detect for a specific key, 
please refer to the INKEY$ or SCANCODE commands found in the Input Command Set. 


SYNTAX: 
WAIT KEY 


SLEEP 
This command will pause the program for the specified Duration. The Duration is specified in milliseconds, 
where 1000 units represent 1 second. 


SYNTAX: 
SLEEP Duration 


WAIT 
This command will pause the program for the specified Duration. The Duration is specified in milliseconds, 
where 1000 units represent 1 second. 


SYNTAX: 
WAIT Duration 


SYNC 

This command is used to improve the performance of demanding programs that require a consistent frame 
rate. This is especially true of games. By default, sync is set to off which allows the system to automatically 
handle screen refreshing. When SYNC ON is used, your program is responsible for handling screen 
refreshing. You can refresh the screen using the SYNC command. When you want the system to 
automatically handle screen refreshing again, you can use the SYNC OFF command. By placing the SYNC 
command at the end of your main program loop, all drawing and refresh tasks can occur in a single call. 
This dramatically increases the speed and smoothness of graphical operations, allowing your programs to 
run at their best. 


SYNTAX: 
SYNC 
SYNC ON 
SYNC OFF 


SYNC RATE 

This command is used to change the default refresh rate SYNC ON uses to control the speed of the SYNC 
update speed. The default rate sustains the 'Frames Per Second’ at no more than 40fps. You can specify 
an integer value from 1 to 1000 to set a new maximum rate. A rate of zero will allow the program to 
refresh as fast as the system will allow. 


SYNTAX: 
SYNC RATE Refresh Rate 


DIM 

This command will create an array in which you can store your program data. You are able to create arrays 
with up to five dimensions. Arrays are best visualized as a line of boxes. Within each of these boxes are 
even smaller boxes. Contained within each of these smaller boxes are single items of data. To locate the 
data contained in one of these boxes, you must indicate exactly which box you wish to read from or write 
to. Each box has what is called an index number. Starting with the largest boxes, you provide an index 
number that takes you inside a box. You can then provide another index number that chooses one of the 
smaller boxes within the larger box. Every time you enter a new box, you are in fact indexing a new 
dimension in the array. Using this method of indexing the array elements, you can read and write to any 
value within the array. You can store only one type of data per array. Data types include integer numbers, 
real numbers and strings. 
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To declare an array as local, you must place the DIM command within the function that intends to use it. To 
declare an array as global, you must place the DIM command at the top of your program. Global arrays can 
be accessed anywhere within your program, including functions. 


SYNTAX: 
DIM Array Name (number of elements) 
DIM Array Name(number of elements, number of elements in each element) 


LOAD ARRAY 

This command will load the contents of the file into the specified array. It is highly recommended that the 
array used to save the data should be identical to the one used when reloading. When specifying the array 
name, the array index numbers are ignored, but you must still provide them to ensure the array is 
recognized. 


SYNTAX: 
LOAD ARRAY Filename, Array Name (index numbers) 


SAVE ARRAY 

This command will save the contents of the array to the specified file. It is highly recommended that the 
array used to save the data should be identical to the one used when reloading. When specifying the array 
name, the array index numbers are ignored, but you must still provide them to ensure the array is 
recognized. 


SYNTAX: 
SAVE ARRAY Filename, Array Name (index numbers) 


UNDIM 

This command will delete the specified array from memory. You must have previously created the array 
using the DIM command in order for UNDIM to succeed. Deleting unused arrays increases system 
performance. 


SYNTAX: 


UNDIM Array Name (number of elements) 


REM 

This command allows you to document your program. The REM command indicates the start of a 'remark' in 
your program, and all remarks are skipped by the compiler. You can use remarks to provide a better 
description of what your program is doing. You will find it good practice to make remarks often, as you will 
gradually forget what each part of your program does as time goes by. 


SYNTAX: 
REM Remarks Go Here 


REMSTART 

This command allows you to document large areas of your program. The REMSTART and REMEND 
commands define an area of your program that will be ignored by the compiler. You can use remarks to 
provide a better description of what your program is doing. You will find it good practice to make remarks 
often, as you will gradually forget what each part of your program does as time goes by. Another use of 
REMSTART and REMEND is to temporarily remove command sequences from your program without having 
to delete them. By placing these commands around the offending commands, the compiler will ignore them 
and will be skipped when the program is run. 


SYNTAX: 
REMSTART 
Remarks Go Here 
REMEND 


REMEND 
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See above. 


#INCLUDE 

You can use this command to include the function declarations of other Dark Basic programs. You can use 
this command to simplify your main program by writing sub-programs that hold re-usable independent 
functions. The #include will associate all the functions within the sub-program with the main program 
during compilation. The Filename String must specify a Dark Basic program in the current project directory. 
You can #include upto 255 sub-programs in total. Sub-programs can also use the #include command to 
further nest sub-programs, but all sub-programs compile into the main program so duplicated function 
names are not allowed. 


SYNTAX: 
#INCLUDE Filename String 


CL$() 

This command will return the string passed in as a command line when the program is run as a standalone 
executable. When this program is created as an EXE file using BUILD EXE or BUILD FINAL, any additional 
parameters entered after the executable name are treated as a single command line string. You can use this 
string to control how your executable behaves based on the contents of the string. 


For example, you may wish to control whether your program runs in 16, 24 or 32 bit display mode. You 
could design your program to understand the command line, "GAME.EXE -depth32". 


SYNTAX: 
Return String=CL$ () 


TIMER() 
This command will get the internal system time, which continually increments at a thousand times a second. 
The system time is returned in milliseconds, where 1000 units represent 1 second. 


SYNTAX: 
Return Value=TIMER () 


GET DATE$() 

This command will return the current clock date as a formatted string. The string contains the date in the 
format MM/DD/YY. MM indicating the current month number 01-12, DD indicating the current date number 
01-31 and YY indicating the current year number 00-99. 


SYNTAX: 
Return String=GET DATES () 


GET TIME$() 

This command will return the current clock time as a formatted string. The string contains the time in the 
format HH:MM:SS. HH indicating the current hour number 00-23, MM indicating the current minute number 
00-59 and SS indicating the current second number 00-59. 


SYNTAX: 
Return String=GET TIMES () 
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Input Command Set 


There are many forms of input data your game can receive in addition to keyboard input. Force-feedback 
joysticks, mice, joypads, head trackers and 3D gloves all supply input data that you may wish to support, 
not to mention file system support to scan for files. 


KEYBOARD COMMANDS 


INPUT 

This command will accept input data from the keyboard and store the entry in the specified variable. The 
string that heads the input command is optional, and allows the user to provide an on-screen prompt for the 
data. The data is output to the screen as it is entered. 


SYNTAX: 
INPUT Variable 
INPUT String, Variable 


INKEY$() 
This command will get the character string of the key currently being pressed. 


SYNTAX: 
Return String=INKEYS () 


UPKEY() 
This command will return an integer value of one if the up arrow key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=UPKEY () 


DOWNKEY() 
This command will return an integer value of one if the down arrow key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=DOWNKEY () 


LEFTKEY() 
This command will return an integer value of one if the left arrow key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=LEFTKEY () 


RIGHTKEY() 
This command will return an integer value of one if the right arrow key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=RIGHTKEY () 


CONTROLKEY() 
This command will return an integer value of one if the control key is being pressed, otherwise zero is 
returned. 
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SYNTAX: 
Return Value=CONTROLKEY () 


SHIFTKEY() 
This command will return an integer value of one if the shift key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=SHIFTKEY () 


SPACEKEY() 
This command will return an integer value of one if the space key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=SPACEKEY () 


RETURNKEY() 
This command will return an integer value of one if the return key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=RETURNKEY () 


ESCAPEKEY() 
This command will return an integer value of one if the escape key is being pressed, otherwise zero is 
returned. 


SYNTAX: 
Return Value=ESCAPEKEY () 


KEYSTATE() 

This command will return an integer value of one if the key specified by the scancode is pressed, otherwise 
zero will be return. The scancode value is the raw value assigned to the key of the keyboard device and 
very often is ordered sequentially from the top left of the keyboard to the bottom right. 


SYNTAX: 
Return Value=KEYSTATE (Scancode) 


SCANCODE() 
This command will get the scancode of the key currently being pressed. 


SYNTAX: 
Return Value=SCANCODE () 


MOUSE COMMANDS 


HIDE MOUSE 
This command will hide the mouse pointer image. 


SYNTAX: 
HIDE MOUSE 


SHOW MOUSE 
This command will let you see the mouse pointer image on screen. 
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SYNTAX: 
SHOW MOUSE 


POSITION MOUSE 
This command will change the position of the mouse pointer. By specifying a 2D screen coordinate using 
integer values, you can relocate the location of the mouse pointer at any time. 


SYNTAX: 
POSITION MOUSE X Coordinate, Y Coordinate 


MOUSEX() 
This command will get the current integer X position of the mouse pointer. 


SYNTAX: 
Return Value=MOUSEX () 


MOUSEY() 
This command will get the current integer Y position of the mouse pointer. 


SYNTAX: 
Return Value=MOUSEY () 


MOUSEZ() 
This command will get the current integer Z position of the mouse pointer. The Z position usually belongs 
to the wheel you can sometimes find in the center of your mouse. The mouse Z position range is 0 to 100. 


SYNTAX: 
Return Value=MOUSEZ () 


MOUSEMOVEX() 

This command will get the current integer X movement value of the mouse pointer. Instead of the actual 
mouse position, this command returns the difference between the current mouse X position and the last 
mouse X position. 


SYNTAX: 
Return Value=MOUSEMOVEX () 


MOUSEMOVEY() 

This command will get the current integer Y movement value of the mouse pointer. Instead of the actual 
mouse position, this command returns the difference between the current mouse Y position and the last 
mouse Y position. 


SYNTAX: 
Return Value=MOUSEMOVEY () 


MOUSEMOVEZ() 

This command will get the current integer Z movement value of the mouse pointer. Instead of the actual 
mouse position, this command returns the difference between the current mouse Z position and the last 
mouse Z position. 


SYNTAX: 
Return Value=MOUSEMOVEZ () 


MOUSECLICK() 
This command will return an integer value if a mouse button is pressed. The integer return value will 
depend on which mouse button has been pressed. A mouse can have up to four buttons, and each one can 
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be detected using this command. Each button is assigned a value. The left button is assigned a value of 1. 
The right button is assigned a value of 2. Buttons three and four are assigned values of 4 and 8 
respectively. When more than one button is pressed, the value of the buttons are added to produce a 
combined value you can check for. For example both left and right mouse buttons pressed together would 
return a value of 3(1+2). 


SYNTAX: 
Return Value=MOUSECLICK () 


GAME DEVICE COMMANDS 


PERFORM CHECKLIST FOR CONTROL DEVICES 

This command will make a checklist of all installed control devices. Control devices can range from a force- 
feedback joystick to head mounted displays. You can read the name of each found device by reading the 
Checklist String after using this command. Additionally, you can determine whether the control device has 
forcefeedback capability by checking for a value of 1 in Checklist Value A. In general, most devices simply 
provide input to the program in a standard X, Y and Z axis format. 


SYNTAX: 
PERFORM CHECKLIST FOR CONTROL DEVICES 


SET CONTROL DEVICE 
This command will select a known control device for use as the current device. You must provide the name 
of the device. 


SYNTAX: 
SET CONTROL DEVICE Device Name$ 


FORCE UP 
This command will use the current control device if it has force feedback capability. The command will force 
the device upward with a power of magnitude specified between 0 and 100. The magnitude should be an 
integer value. 


SYNTAX: 
FORCE UP Magnitude Value 


FORCE DOWN 

This command will use the current control device if it has force feedback capability. The command will force 
the device downward with a power of magnitude specified between 0 and 100. The magnitude should be an 
integer value. 


SYNTAX: 
FORCE DOWN Magnitude Value 


FORCE LEFT 

This command will use the current control device if it has force feedback capability. The command will force 
the device left with a power of magnitude specified between 0 and 100. The magnitude should be an 
integer value. 


SYNTAX: 
FORCE LEFT Magnitude Value 


FORCE RIGHT 

This command will use the current control device if it has force feedback capability. The command will force 
the device right with a power of magnitude specified between 0 and 100. The magnitude should be an 
integer value. 
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SYNTAX: 
FORCE RIGHT Magnitude Value 


FORCE ANGLE 

This command will use the current control device if it has force feedback capability. The command will force 
the device in the direction specified by the angle value and at a power of magnitude specified between 0 
and 100. The delay value specifies how many milliseconds to sustain the effect of force. The magnitude and 
delay should be integer values. A delay value of zero indicates an infinite effect of force. The angle value 
should be a real number. 


SYNTAX: 
FORCE ANGLE Magnitude Value, Angle Value, Delay Value 


FORCE CHAINSAW 

This command will use the current control device if it has force feedback capability. The command will force 
the device to rattle like a chainsaw at a power of magnitude specified between 0 and 100. The delay value 
specifies how many milliseconds to sustain the effect of force. A delay value of zero indicates an infinite 
effect of force. The magnitude and delay should be integer values. 


SYNTAX: 
FORCE CHAINSAW Magnitude Value, Delay Value 


FORCE SHOOT 

This command will use the current control device if it has force feedback capability. The command will force 
the device to recoil like a discharging pistol at a power of magnitude specified between 0 and 100. The 
delay value specifies how many milliseconds to sustain the effect of force. A delay value of zero indicates an 
infinite effect of force. The magnitude and delay should be integer values. 


SYNTAX: 
FORCE SHOOT Magnitude Value, Delay Value 


FORCE IMPACT 

This command will use the current control device if it has force feedback capability. The command will force 
the device to shudder at a power of magnitude specified between 0 and 100. The delay value specifies how 
many milliseconds to sustain the effect of force. A delay value of zero indicates an infinite effect of force. 
The magnitude and delay should be integer values. 


SYNTAX: 
FORCE IMPACT Magnitude Value, Delay Value 


FORCE NO EFFECT 
This command will use the current control device if it has force feedback capability. The command will force 
the device to halt the effect of any forces. 


SYNTAX: 
FORCE NO EFFECT 


FORCE WATER EFFECT 

This command will use the current control device if it has force feedback capability. The command will force 
the device to simulate the effect of moving through water. The force applied to any joystick movement will 
simulate a dampening effect when fast movements are attempted by the user. The magnitude value 
determines the strength of the force between 0 and 100. The delay value indicates how many milliseconds 
the effect lasts for. A delay value of zero indicates an infinite effect of force. The magnitude and delay 
should be integer values. 


SYNTAX: 
FORCE WATER EFFECT Magnitude Value, Delay Value 
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FORCE AUTO CENTER ON 
This command will use the current control device if it has force feedback capability. The command will force 
the device to pull to a central position as though connected by springs. 


SYNTAX: 
FORCE AUTO CENTER ON 


FORCE AUTO CENTER OFF 
This command will use the current control device if it has force feedback capability. The command will 
deactivate any effect of force that has been created with the FORCE AUTO CENTER ON command. 


SYNTAX: 
FORCE AUTO CENTER OFF 


JOYSTICK COMMANDS 


JOYSTICK X() 
This command will return the X axis value of the default analogue joystick. 


SYNTAX: 
Return Value=JOYSTICK X() 


JOYSTICK Y() 
This command will return the Y axis value of the default analogue joystick. 


SYNTAX: 
Return Value=JOYSTICK Y() 


JOYSTICK Z() 
This command will return the Z axis value of the default analogue joystick. 


SYNTAX: 
Return Value=JOYSTICK 


N 


JOYSTICK FIRE A() 
This command will return an integer value of one if the default joystick fire button A is pressed, otherwise 
zero will be returned. 


SYNTAX: 
Return Value=JOYSTICK FIRE A() 


JOYSTICK FIRE B() 
This command will return an integer value of one if the default joystick fire button B is pressed, otherwise 
zero will be returned. 


SYNTAX: 
Return Value=JOYSTICK FIRE B() 


JOYSTICK FIRE C() 
This command will return an integer value of one if the default joystick fire button C is pressed, otherwise 
zero will be returned. 


SYNTAX: 
Return Value=JOYSTICK FIRE C() 
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JOYSTICK FIRE D() 
This command will return an integer value of one if the default joystick fire button D is pressed, otherwise 
zero will be returned. 


SYNTAX: 
Return Value=JOYSTICK FIRE D() 


JOYSTICK UP() 
This command will return an integer value of one if the default joystick is pushed up, otherwise zero is 
return. 


SYNTAX: 
Return Value=JOYSTICK UP() 


JOYSTICK DOWN() 
This command will return an integer value of one, if the default joystick is pushed down, otherwise zero is 
return. 


SYNTAX: 
Return Value=JOYSTICK DOWN () 


JOYSTICK LEFT() 
This command will return an integer value of one if the default joystick is pushed left, otherwise zero is 
return. 


SYNTAX: 
Return Value=JOYSTICK LEFT () 


JOYSTICK RIGHT() 
This command will return an integer value of one if the default joystick is pushed right, otherwise zero is 
return. 


SYNTAX: 
Return Value=JOYSTICK RIGHT () 


JOYSTICK SLIDER A() 
This command will return the Slider A value of the default analogue joystick. 


SYNTAX: 
Return Value=JOYSTICK SLIDER A() 


JOYSTICK SLIDER B() 
This command will return the Slider B value of the default analogue joystick. 


SYNTAX: 
Return Value=JOYSTICK SLIDER B() 


JOYSTICK SLIDER C() 
This command will give support for a third slider value. 


SYNTAX: 
Return Value = JOYSTICK SLIDER C() 


JOYSTICK SLIDER D() 
This command will give support for a forth slider value. 


SYNTAX: 
Return Value = JOYSTICK SLIDER D() 
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JOYSTICK TWIST X() 
This command will give support for reading joystick X twist. 


SYNTAX: 
Return Value = JOYSTICK TWIST X() 


JOYSTICK TWIST Y() 
This command will give support for reading joystick Y twist. 


SYNTAX: 
Return Value = JOYSTICK TWIST Y() 


JOYSTICK TWIST Z() 
This command will give support for reading joystick Z twist. 


SYNTAX: 
Return Value = JOYSTICK TWIST Z() 


JOYSTICK HAT ANGLE() 

This command will give support for reading up to 4 HAT controllers. When the hat controller is neutral, a 
value of -1 is returned. When the hat is being used, the return value is in hundredths of a degree so north 
would be zero, east would be 9000, south is 18000 and west is 27000. 


SYNTAX: 
Return Value = JOYSTICK HAT ANGLE (Hat Number) 


CONTROL DEVICE NAME$() 
This command will return a string of the name of the current control device. 


SYNTAX: 
Return Value=CONTROL DEVICE NAMES () 


CONTROL DEVICE X() 
This command will return the X axis value of the current control device. 


SYNTAX: 
Return Value=CONTROL DEVICE X() 


CONTROL DEVICE Y() 
This command will return the Y axis value of the current control device. 


SYNTAX: 
Return Value=CONTROL DEVICE Y() 


CONTROL DEVICE Z() 
This command will return the Z axis value of the current control device. 


SYNTAX: 
Return Value=CONTROL DEVICE 2Z() 


FTP COMMANDS 


FTP CONNECT 
This command will allow you to connect to an FTP site. 


SYNTAX: 
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FTP CONNECT UrlS$, UserS, Password$ 


FTP SET DIR 
This command will allow you to go to an FTP directory. 


SYNTAX: 
FTP SET DIR Directory$ 


FTP FIND FIRST 
This command will allow you to find first ftp file in current ftp directory. 


SYNTAX: 
FTP FIND FIRST 


FTP FIND NEXT 
This command will allow you to find next ftp file in current ftp directory. 


SYNTAX: 
FTP FIND NEXT 


FTP PUT FILE 
This command will allow you to copy local file into current ftp directory. 


SYNTAX: 
FTP PUT FILE Local Filename$ 


FTP DELETE FILE 
This command will allow you to delete an ftp file from the current ftp directory. 


SYNTAX: 
FTP DELETE FILE Ftp Filename$ 


FTP GET FILE 
This command will allow you to copy a file from the current ftp folder to the local directory. 


SYNTAX: 
FTP GET FILE Ftp Filename$, Local filename$ 


FTP GET FILE 

This command will allow you to use FTP PROCEED to grab. The GrabInBits Flag allows you to specify the 
amount in bytes to be grabbed each time FTP PROCEED is called, thus controlling the rate and 
responsiveness of your application during download. 


SYNTAX: 
FTP GET FILE Ftp FilenameS, Local filename$, GrabInBits Flag 


FTP DISCONNECT 

This command will allow you to disconnect from an ftp site previously connected to using the FTP CONNECT 
command. You can optionally specify an integer parameter to disconnect the dial-up connection if dial-up 
access was used. 


SYNTAX: 
FTP DISCONNECT 
FTP DISCONNECT DialUp Disconnect Flag 


FTP PROCEED 


Grab another chunk of the downloading file started by FTP GET FILE. This command will only work if you 
have specified the GetInBits flag of the FTP GET FILE command. 


50 


SYNTAX: 
FTP PROCEED 


FTP TERMINATE 
This command will allow you to terminate a current download started by FTP GET FILE. 


SYNTAX: 
FTP TERMINATE 


GET FTP STATUS() 
This command will return zero if the ftp connection has failed. 


SYNTAX: 
Return Value = GET FTP STATUS () 


GET FTP DIR$() 
This command will return the current ftp directory. 


SYNTAX: 
Return Value = GET FTP DIRS$() 


GET FTP FILE NAMES$() 
This command will return the ftp filename pointed to by the commands FTP FIND FIRST and FTP FIND 
NEXT. 


SYNTAX: 
Return String = GET FTP FILE NAMES () 


GET FTP FILE TYPE() 
This command will return the ftp file type pointed to by the commands FTP FIND FIRST and FTP FIND 
NEXT. 


SYNTAX: 
Return Value = GET FTP FILE TYPE() 


GET FTP FILE SIZE() 
This command will return the size of the current ftp file being pointed to. 


SYNTAX: 
Return Value = GET FTP FILE SIZE() 


GET FTP PROGRESS() 
This command will return a percentage value of the amount of the file being downloaded. See FTP 
PROCEED and FTP GET FILE. 


SYNTAX: 
Return Value = GET FTP PROGRESS () 


GET FTP FAILURE() 
This command will return a one if the ftp connection has failed to execute an ftp command. If a one was 
returned, you can use the GET FTP ERROR$() command to determine the actual reason for the failure. 


SYNTAX: 
Return Value = GET FTP FAILURE () 


GET FTP ERRORS() 
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This command will return a string containing the description of a failure from a previously called ftp 
command. You can determine whether an ftp command has failed by calling the GET FTP FAILURE() 
command. 


SYNTAX: 
Return String = GET FTP ERRORS () 


FILE SYSTEM COMMANDS 


DIR 
This command will output the entire contents of the current working directory to the screen. The command 
serves little use for effective file scanning, but provides a simple way to view files. 


SYNTAX: 
DIR 


DRIVELIST 
This command will output the available drives to the screen. The command serves little use for effective 
drive scanning, but provides a simple way to view available drives. 


SYNTAX: 
DRIVELIST 


PERFORM CHECKLIST FOR FILES 

This command will output the contents of the current working directory to a checklist. The command 
provides a convenient way to store the contents of a directory without using additional data structures, but 
does tie up the checklist when in use. 


SYNTAX: 
PERFORM CHECKLIST FOR FILES 


PERFORM CHECKLIST FOR DRIVES 

This command will output the available drives to a checklist. The command provides a convenient way to 
store the available drives without using additional data structures, but does tie up the checklist when in 
use.- 


SYNTAX: 
PERFORM CHECKLIST FOR DRIVES 


SET DIR 

This command will set the current working directory to the specified path. The path can be absolute or 
relative. Absolute paths contain the entire path including the drive letter. A relative path assumes the 
program has a valid current working directory and continues the path from the current location. 


SYNTAX: 
SET DIR Paths 


CD 

This command will set the current working directory to the specified path. The path can be absolute or 
relative. Absolute paths contain the entire path including the drive letter. A relative path assumes the 
program has a valid current working directory and continues the path from the current location. 


SYNTAX: 
CD Paths 


FIND FIRST 
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This command will begin a file search by locating the first file in the current working directory. If this 
command succeeds, a file will be stored internally and its data can be extracted using the GET FILE 
NAME$(), GET FILE DATE$() and GET FILE TYPE() commands. 


SYNTAX: 
FIND FIRST 


FIND NEXT 

This command will continue a file search by locating the next file in the current working directory. If this 
command succeeds, a file will be stored internally and its data can be extracted using the GET FILE 
NAME$(), GET FILE DATE$() and GET FILE TYPE() commands. A file search can be started with the FIND 
FIRST command. 


SYNTAX: 
FIND NEXT 


MAKE FILE 
This command will create an empty file. The filename must not exist or the command will fail. 


SYNTAX: 
MAKE FILE Filename 


DELETE FILE 
This command will delete an existing file. The file must exist or the command will fail. 


SYNTAX: 
DELETE FILE Filename 


COPY FILE 
This command will copy an existing file to a new file. The destination filename must not exist or the 
command will fail. 


SYNTAX: 


COPY FILE Source Filename, Destination Filename 


MOVE FILE 
This command will move an existing file to a new location. The destination filename must not exist or the 
command will fail. 


SYNTAX: 


MOVE FILE Source Filename, Destination Filename 


RENAME FILE 
This command will rename an existing file to a new name. The new filename must not exist or the 
command will fail. 


SYNTAX: 
RENAME FILE Source Filename, New Filename 


EXECUTE FILE 

This command will shell execute a file. The command line is used to pass additional data into the file being 
executed. The directory is used to optionally specify a directory other than the current directory. The file 
must exist or the command will fail. Passing a document, rather than an executable as the filename will 
cause the document to be opened. 


SYNTAX: 
EXECUTE FILE Filename, Commandline, Directory 
EXECUTE FILE FilenameS, String$S, Path$, WaitForTermination Flag 
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MAKE DIRECTORY 
This command will create an empty directory. The directory name must not exist or the command will fail. 


SYNTAX: 
MAKE DIRECTORY Directory Name 


DELETE DIRECTORY 
This command will delete an existing directory. The directory must exist or the command will fail. 


SYNTAX: 
DELETE DIRECTORY Directory Name 


OPEN TO READ 
This command will open a file, ready for reading. The file must exist or the command will fail. You can open 
upto 32 files at the same time, using a file number range of 1 through to 32. 


SYNTAX: 
OPEN TO READ File Number, Filename 


OPEN TO WRITE 
This command will open a file, ready for writing. The file must not exist or the command will fail. You can 
open upto 32 files at the same time, using a file number range of 1 through to 32. 


SYNTAX: 
OPEN TO WRITE Number, Filename 


CLOSE FILE 
This command will close a file that has been previously opened using OPEN TO READ or OPEN TO WRITE. 
The file must be open or the command will fail. 


SYNTAX: 
CLOSE FILE File Number 


READ FILE 
This command will read a long word of data from the file and store it as an integer value in the variable 
specified. The file specified by the file number must be open or the command will fail. 


SYNTAX: 
READ FILE File Number, Variable 


READ BYTE 
This command will read a byte of data from the file and store it as an integer value in the variable specified. 
The file specified by the file number must be open or the command will fail. 


SYNTAX: 
READ BYTE File Number, Variable 


READ WORD 

This command will read a word of data from the file and store it as an integer value in the variable 
specified. A word represents two bytes. The file specified by the file number must be open or the command 
will fail. 


SYNTAX: 
READ WORD File Number, Variable 


READ LONG 
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This command will read a long word of data from the file and store it as an integer value in the variable 
specified. A long word represents four bytes. The file specified by the file number must be open or the 
command will fail. 


SYNTAX: 
READ LONG File Number, Variable 


READ FLOAT 
This command will read a float from the file and store it as an real value in the real variable specified. The 
file specified by the file number must be open or the command will fail. 


SYNTAX: 
READ FLOAT File Number, Variable 


READ STRING 
This command will read a string from the file and store it as a string in the variable specified. The file 
specified by the file number must be open or the command will fail. 


SYNTAX: 
READ STRING File Number, Variable String 


WRITE FILE 
This command will write a long word of data to the file from an integer value. The file specified by the file 
number must be open or the command will fail. 


SYNTAX: 
WRITE FILE File Number, Value 


WRITE BYTE 
This command will write a byte of data to the file from an integer value. The file specified by the file 
number must be open or the command will fail. 


SYNTAX: 
WRITE BYTE File Number, Value 


WRITE WORD 
This command will write a word of data to the file from an integer value. A word represents two bytes. The 
file specified by the file number must be open or the command will fail. 


SYNTAX: 
WRITE WORD File Number, Value 


WRITE LONG 
This command will write a long word of data to the file from an integer value. A long word represents four 
bytes. The file specified by the file number must be open or the command will fail. 


SYNTAX: 
WRITE LONG File Number, Value 


WRITE FLOAT 
This command will write a float to the file from a real value. The file specified by the file number must be 
open or the command will fail. 


SYNTAX: 
WRITE FLOAT File Number, Value 


WRITE STRING 
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This command will write the specified string to the file. The string will be terminated in the file with the 
standard carriage return ASCII characters (13)+(10). The file specified by the file number must be open or 
the command will fail. 


SYNTAX: 
WRITE STRING File Number, String 


READ FILEBLOCK 
This command will extract an entire file from a pack file. A pack file is like a normal file you create yourself 
using the OPEN and CLOSE commands, but has the additional feature of storing entire files and directories. 


SYNTAX: 
READ FILEBLOCK File Number, Filename to Create 


READ DIRBLOCK 

This command will extract an entire directory from a pack file. A pack file is like a normal file you create 
yourself using the OPEN and CLOSE commands, but has the additional feature of storing entire files and 
directories. 


SYNTAX: 
READ DIRBLOCK File Number, Folder to Create 


WRITE FILEBLOCK 
This command will write a file to a pack file. A pack file is like a normal file you create yourself using the 
OPEN and CLOSE commands, but has the additional feature of storing entire files and directories. 


SYNTAX: 
WRITE FILEBLOCK File Number, Filename to Read 


WRITE DIRBLOCK 
This command will write an entire directory to a pack file. A pack file is like a normal file you create yourself 
using the OPEN and CLOSE commands, but has the additional feature of storing entire files and directories. 


SYNTAX: 
WRITE DIRBLOCK File Number, Folder to Read 


MAKE MEMBLOCK FROM FILE 

Create a memblock from the file specified. The memblock will be the same size as the currently open file, 
and contain the entire data of the file specified. You must specify the file and memblock numbers using 
integer values. 


SYNTAX: 
MAKE MEMBLOCK FROM FILE File Number, Memblock Number 


READ MEMBLOCK 

Create a memblock from the currently open file. The file must contain a memblock created with the WRITE 
MEMBLOCK command, at the exact position within the file. You must specify the file and memblock 
numbers using integer values. 


SYNTAX: 
READ MEMBLOCK File Number, Memblock Number 


WRITE MEMBLOCK 

Write the specified memblock to a file open for writing. You can store multiple memblocks within a currently 
open file, and is useful for creating your own file formats. To retrieve the memblock you must use the READ 
MEMBLOCK command. You must specify the file and memblock numbers using integer values. 


SYNTAX: 
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WRITE MEMBLOCK File Number, Memblock Number 


WRITE TO CLIPBOARD 

This command will write a string to the system clipboard. The system clipboard remains in tact even after 
the program has been terminated and can be used to transfer values from program to program, or 
otherwise retain string data beyond the scope of the program. 


SYNTAX: 
WRITE TO CLIPBOARD String 


GET DIRS$() 
This command will get the absolute path of the current working directory. Absolute paths contain the entire 
path including the drive letter. 


SYNTAX: 
Return String=GET DIRS () 


GET FILE NAMES$() 
This command will get the filename of the file currently recorded by the file search commands FIND FIRST 
and FIND NEXT. 


SYNTAX: 
Return String=GET FILE NAMES () 


GET FILE DATES$() 
This command will get the date string of the file currently recorded by the file search commands FIND 
FIRST and FIND NEXT. 


SYNTAX: 
Return String=GET FILE DATES () 


GET FILE TYPE() 

This command will get the type value of the file currently recorded by the file search commands FIND FIRST 
and FIND NEXT. A type value of zero indicates it is a file. A type value of 1 indicates it is a directory. A type 
value of -1 indicates there are no more files in the current working directory. 


SYNTAX: 
Return Value=GET FILE TYPE () 


FILE EXIST() 
This command will return an integer value of one if the specified file exists, otherwise zero is returned. 


SYNTAX: 
Return Value = FILE EXIST(Filename String) 


PATH EXIST() 
This command will return an integer value of one if the specified path exists, otherwise zero is returned. 
You can use this command to check whether a directory exists. 


SYNTAX: 
Return Value = PATH EXIST(Pathname String) 


FILE SIZE() 
This command will return the size of the specified file in bytes, otherwise zero is returned. The file must 
exist or the command will fail. 


SYNTAX: 
Return Value = FILE SIZE(Filename String) 
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FILE OPEN() 
This command will return an integer value of one if the file specified by the file number is open, otherwise 
zero is returned. 


SYNTAX: 
Return Value = FILE OPEN (File Number) 


FILE END() 
This command will return an integer value of one if the file specified by the file number has no more data to 
read, otherwise zero is returned. 


SYNTAX: 
Return Value = FILE END(File Number) 


GET CLIPBOARDS$() 

This command will read a string stored in the system clipboard. The system clipboard remains in tact even 
after the program has been terminated and can be used to transfer values from program to program, or 
otherwise retain string data beyond the scope of the program. 


SYNTAX: 
Return String=GET CLIPBOARDS () 


GET REGISTRY 
Get a value from the specified registry location. The folder name points to the general area within the 
registry. The key name points to the label that describes the data stored within the registry folder. 


SYNTAX: 
Return Value = GET REGISTRY (Folder Name, Key Name) 


WRITE TO REGISTRY 

Write a value to the specified registry location. The folder name points to the general area within the 
registry. The key name points to the label that describes the data stored within the registry folder. The 
value is the integer value you wish to store. 


SYNTAX: 
WRITE TO REGISTRY Folder Name, Key Name, Value 


CLEAR ENTRY BUFFER 

This command will clear the entry buffer used by Windows. The entry buffer stores every ASCII key press 
allowing you to collect text typed on the keyboard perfectly and will not be affected by the refresh rate of 
your application. 


SYNTAX: 
CLEAR ENTRY BUFFER 


ENTRY$ 

Returns a string containing all text entered and captured by the keyboard buffer. The entry buffer stores 
every ASCII key press allowing you to collect text typed on the keyboard perfectly and will not be affected 
by the refresh rate of your application. 


SYNTAX: 
Return String = ENTRYS () 
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Math Command Set 


In addition to all the standard mathematical forms and conditional operators you are able to use a number 
of useful expressions. Everything from calculating the arc of a circle to generating a random number can 
increase the sophistication of your programs. 


INC 
The INC command will increment a variable by a specified Value or by a default of 1. Both integer and real 
variables can be incremented by either an integer or real value. 


SYNTAX: 
INC Variable 
INC Variable, Value 


DEC 
The DEC command will decrement a variable by a specified Value or by a default of 1. Both integer and real 
variables can be decremented by either an integer or real value. 


SYNTAX: 
DEC Variable 
DEC Variable, Value 


RANDOMIZE 

The RANDOMIZE command reseeds the random number generator. If the random number generator is not 
reseeded the RND() command can return the same sequence of random numbers. To change the sequence 
of random number every time the program is run, place a randomize statement with an integer number at 
the beginning of the program and change the value with each run. 


SYNTAX: 
RANDOMIZE Integer Value 


SQRT() 
This command will return the square root of a value. The value can be an integer or real number. The 
return value will be a real number. 


SYNTAX: 
Return Value=SQRT (Value) 


ABS() 
This command will return the positive equivalent of a value. The value can be a real or integer number. The 
return value can be a real or integer number. 


SYNTAX: 
Return Value=ABS (Value) 


INT() 
This command will return the largest integer before the decimal point of a real number. The return value 
should be an integer number. 


SYNTAX: 
Return Value=INT (Value) 


RND() 
This command will return a random number between 0 and the range provided. The integer range will be 
the highest number you want returned. The return value should be an integer number. 
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SYNTAX: 
Return Value=RND (Range Value) 


EXP() 
This command will return a result raised to the power of value. The value should be an integer number. The 
return value should be an integer number. 


SYNTAX: 
Return Value=EXP (Value) 


cos() 
This command will return the cosine of value were the value is in degrees between 0 and 360. The value 
can be a real or integer number. The return value should be a real number. 


SYNTAX: 
Return Value=COS (Value) 


SIN() 
This command will return the sine of value where value is in degrees between 0 and 360. The value can be 
a real or integer number. The return value should be a real number. 


SYNTAX: 
Return Value=SIN (Value) 


TAN() 
This command will returns the tangent of the value. The value can be a real or integer number. The return 
value should be a real number. 


SYNTAX: 
Return Value=TAN (Value) 


ACOS() 
This command will return the arccosine of a value. The value can be a real or integer number. The return 
value should be a real number. 


SYNTAX: 
Return Value=ACOS (Value) 


ASIN() 
This command will return the arcsine of value. The value can be a real or integer number. The return value 
should be a real number. 


SYNTAX: 
Return Value=ASIN (Value) 


ATAN() 
This command will return the tangent in degrees between 0 and 360. The value can be a real or integer 
number. The return value should be a real number. 


SYNTAX: 
Return Value=ATAN (Value) 


ATANFULL() 

This command will return the angle of two points in degrees between 0 and 360. The distance values are 
calculated by finding the distance between two points for both the X and Y axis. The distance values can be 
a real or integer number. The return value should be a real number. 
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SYNTAX: 
Return Value=ATANFULL (Distance X, Distance Y) 


HCOS() 
This command will return the hyperbolic cosine of the value. The value can be a real or integer number. The 
return value should be a real number. 


SYNTAX: 
Return Value=HCOS (Value) 


HSIN() 
This command will return the hyperbolic sine of the value. The value can be a real or integer number. The 
return value should be a real number. 


SYNTAX: 
Return Value=HSIN (Value) 


HTAN() 
This command will return the hyperbolic tangent of value. The value can be a real or integer number. The 
return value should be a real number. 


SYNTAX: 
Return Value=HTAN (Value) 
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Basic 2D Command Set 


You can create graphics of your own using standard draw commands. You are able to draw dots, lines, 
boxes, circles and ellipses in any color. You have the tools available to create your own painting package. 
Standard 2D commands allow you to generate your graphics during the program, reducing the need to store 
bitmaps and other visual media. 


CLS 

This command will clear the screen using current ink color or the specified color value. Color values range 
from 0 to over 16 million, that represent every combination of red, green and blue to make up the final 
Color. You can use the RGB command to make the generation of the Color value straight forward. The 
parameter should be specified using integer values. You can also clear a bitmap, by using the SET CURRENT 
BITMAP command. 


SYNTAX: 
CLS 
CLS Color Value 


INK 

This command will set the current ink color using the specified color value. color values range from 0 to 
over 16 million, that represent every combination of red, green and blue to make up the final color. You can 
use the RGB command to make the generation of the color value straight forward. The parameter should be 
specified using integer values. 


SYNTAX: 


INK Foreground color Value, Background color Value 


DOT 

This command will put a pixel on the screen in the current ink color. The command requires the Co- 
ordinates to place the pixel on the screen. The parameters should be specified using integer values. You can 
also draw to a bitmap, by using the SET CURRENT BITMAP command. 


SYNTAX: 
DOT X, Y 


BOX 

This command will draw a filled box on screen in the current ink color. The command requires the top left 
and bottom right coordinates of the box. The parameters should be specified using integer values. You can 
also draw to a bitmap, by using the SET CURRENT BITMAP command. 


SYNTAX: 
BOX Left, Top, Right, Bottom 


LINE 

This command will put a line on the screen in the current ink color. The command requires two sets of 
Coordinates to draw a line from one to the other on the screen. The parameters should be specified using 
integer values. You can also draw to a bitmap, by using the SET CURRENT BITMAP command. 


SYNTAX: 
LINE Xa, Ya, Xb, Yb 


CIRCLE 
This command will draw a circle on screen using the current ink color. The command requires the radius 
and the Coordinates that will represent the center of the circle to be drawn. The parameters should be 
specified using integer values. You can also draw to a bitmap, by using the SET CURRENT BITMAP 
command. 
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SYNTAX: 
CIRCLE X, Y, Radius 


ELLIPSE 

This command will draw an ellipse on screen using the current ink color. The command requires the X- 
Radius, Y-Radius and the Coordinates that will represent the center of the ellipse to be drawn. The 
parameters should be specified using integer values. You can also draw to a bitmap, by using the SET 
CURRENT BITMAP command. 


SYNTAX: 
ELLIPSE X, Y, X-Radius, Y-Radius 


POINT() 

This command will return the pixel color value from the screen at the specified Coordinates. The parameters 
should be specified using integer values. You can also read from bitmaps by using the SET CURRENT 
BITMAP command. 


SYNTAX: 
Return Value=POINT (X,Y) 


RGB() 

This command will return the final color value of a combination of red, green and blue intensities. For each 
of the Red, Green and Blue components you must enter a value between 0 and 255. All zero will return a 
color value that represents black. All 255 will return a color value that represents white. The parameters 
should be specified using integer values. You can also determine the individual color components from the 
combined color value by using the commands RGBR, RGBG and RGBB specifying the known color value. 


SYNTAX: 
Color Value=RGB(Red Value, Green Value, Blue Value) 
Red Value=RGBR(Color Value) 
Green Value=RGBG (Color Value) 
Blue Value=RGBB (Color Value) 
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Text Command Set 


Instructions such as SET CURSOR and PRINT are provided for beginners. For more advanced users specific 
fonts, sizes, positions, styles and colors are provided to enhance the presentation of text. Text strings can 
be manipulated in many ways including the conversion of text to numbers and the extraction of individual 
characters. 


SET CURSOR 
This command will set the cursor position used by the PRINT command. You can use this command to place 
basic text anywhere on the screen. The coordinates should be integer values. 


SYNTAX: 
SET CURSOR X, Y 


PRINT 

This command will print text, numbers, variables and strings to the screen. You can position where the text 
will print using the SET CURSOR command. You can separate items you wish to print on the same line by 
using either a semi-colon or a comma. If you add a semi-colon at the end of your print list, the next PRINT 
command will add to the end of the last print line. 


SYNTAX: 
PRINT print list 


TEXT 
This command will output the provided string using the current text settings at the specified coordinates on 
the screen. The coordinates should be integer values. 


SYNTAX: 
TEXT X, Y, String$ 


CENTER TEXT 
This command will output the provided string using the current text settings at the specified coordinates. 
The text will be centered on the X coordinate given. The coordinates should be integer values. 


SYNTAX: 
CENTER TEXT X, Y, String$ 


PERFORM CHECKLIST FOR FONTS 
This command will build a checklist and search for all available fonts on the system. 


SYNTAX: 
PERFORM CHECKLIST FOR FONTS 


SET TEXT FONT 
This command will set the typeface of the font you wish to use. 


SYNTAX: 
SET TEXT FONT Typeface$ 


SET TEXT SIZE 
This command will set the point size of any text you are about to output. The point size should be an 
integer value. 


SYNTAX: 
SET TEXT SIZE Point Size 
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SET TEXT TO NORMAL 
This command will set text style to non-bold and non-italic. 


SYNTAX: 
SET TEXT TO NORMAL 


SET TEXT TO ITALIC 
This command will set the text style to non-bold and italic. 


SYNTAX: 
SET TEXT TO ITALIC 


SET TEXT TO BOLD 
This command will set the text style to bold and non-italic. 


SYNTAX: 
SET TEXT TO BOLD 


SET TEXT TO BOLD ITALIC 
This command will set the text style to bold and italic. 


SYNTAX: 
SET TEXT TO BOLD ITALIC 


SET TEXT OPAQUE 
This command will set the background of the current text settings to the color of the background ink. 


SYNTAX: 
SET TEXT OPAQUE 


SET TEXT TRANSPARENT 
This command will set the background of the text you are about to output as transparent. 


SYNTAX: 
SET TEXT TRANSPARENT 


ASC() 
This command will return an integer value that represents the ASCII code for the first character of the 
provided string. 


SYNTAX: 
Return Value=ASC (String) 


VAL() 
This command will return an integer number of the string provided by converting the string to a numerical 
form. 


SYNTAX: 
Return Value=VAL (String) 


BINS() 


This command will return a 32 character string equivalent to the binary representation of the specified value 
provided. The value provided should be an integer value. 


SYNTAX: 
Return String=BINS (Value) 
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CHR$() 

This command will return a character string equivalent to the ASCII character number provided. ASCII is a 
standard way of coding the characters used to construct strings. The value provided should be an integer 
value. 


SYNTAX: 
Return String=CHRS (Value) 


HEX$() 
This command will return an eight character string equivalent to the hexadecimal representation of the 
number provided. The value provided should be an integer value. 


SYNTAX: 
Return String=HEXS (Value) 


LEFT$() 

This command will return a string containing the leftmost characters of the string that was provided. If the 
value is greater than the number of characters in string then the entire string is return. If the value is zero 
then an empty string is returned. The value provided should be an integer value. 


SYNTAX: 
Return String=LEFTS (String, Value) 


LEN() 
This command will return the number of characters in the string provided. Non-printable control characters 
and blanks are counted. 


SYNTAX: 
Return Value=LEN (String) 


MIDS() 
This command will extract a character from the string provided. The return string will contain a single 
character extracted from the string specified. The value provided should be an integer value. 


SYNTAX: 
Return String=MIDS$ (String, Value) 


RIGHT$() 
This command will return the rightmost set of characters. The value specifies the number of characters to 
extract from the string provided. The value provided should be an integer value. 


SYNTAX: 
Return String=RIGHTS (String, Value) 


STRS$() 
This command will return a string representation of the value provided. The value provided should be an 
integer value. 


SYNTAX: 
Return String=STRS (Value) 
LOWERS() 
This command will return a string converting the specified string to lowercase. 
SYNTAX: 


Return String=LOWERS (String) 
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UPPERS$() 
This command will return a string converting the specified string to uppercase. 


SYNTAX: 
Return String=UPPERS (String) 


TEXT FONTS$() 
This command will return a string containing the typeface description of the current text settings. 


SYNTAX: 
Return String=TEXT FONTS () 


TEXT SIZE() 
This command will return the point size of the current font described by the current text settings. 


SYNTAX: 
Return Value=TEXT SIZE() 


TEXT STYLE() 
This command will return a code based on the style of the current text settings. The return value will be an 
integer number of zero for normal, 1 for italic, 2 for bold and 3 for bold italic. 


SYNTAX: 
Return Value=TEXT STYLE () 


TEXT BACKGROUND TYPE() 
This command will return an integer value of one if the current text settings is set to using a transparent 
background, otherwise zero is returned. 


SYNTAX: 
Return Value=TEXT BACKGROUND TYPE () 


TEXT WIDTH() 
This command will return the width of the provided string using the current text settings. 


SYNTAX: 
Return Value=TEXT WIDTH (String$) 


TEXT HEIGHT() 
This command will return the height of the provided string using the current text settings. 


SYNTAX: 
Return Value=TEXT HEIGHT (String$) 
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Screen Command Set 


The screen can be set to any mode your graphics card supports excluding 8bit display modes (256 colours). 
The default display mode is 640 x 480 x 16bit and is the most common resolution to use. You are only 
limited by the speed, capacity and capability of your graphics card when setting your display mode. Avoid 
setting a display mode that consumes most of your available video memory as this will impair 3D 
performance. Avoid setting a display mode that exceeds your available video memory as this will 
dramatically slow down your screen refresh rate. 


PERFORM CHECKLIST FOR DISPLAY MODES 
This command will scan your system and make a checklist of all display modes your video card can handle. 


SYNTAX: 
PERFORM CHECKLIST FOR DISPLAY MODES 


SET DISPLAY MODE 

This command will set the screen display mode if it is available on the current graphics card. If this 
command fails, it will only generate a runtime warning in the CLI. A final EXE produced with this command 
will not cause your program to fail on machines that do not support the resolution. It is recommended, 
however, that you check the availability of the display mode before using this command. You can use the 
CHECK DISPLAY MODE() command to see whether the display mode is supported. 


SYNTAX: 
SET DISPLAY MODE Width, Height, Depth 


SET GAMMA 

This command will set the screens red, green and blue gamma levels. You can change the gamma to fade 
in and out the contents of the screen or alter the ratio of colours displayed. The red, green and blue 
component values can range from 0 to 511, with 255 being the default values. Reducing these values fades 
each colour component out of the screen, and above the default value enhances the ratio of the component 
colour. Some graphics cards do not support gamma alteration. 


SET GAMMA Red, Green, Blue 


CHECK DISPLAY MODE() 
This command will check that the display mode you have specified is available on the current system. The 
parameters should use integer values. 


SYNTAX: 
Return Value=CHECK DISPLAY MODE (Width, Height, Depth) 


SCREEN TYPE() 
This command will return an integer value of the current screen type. A returned value of 0 indicates the 
screen is not hardware accelerated. A returned value of 1 indicates the screen is hardware accelerated. 


SYNTAX: 
Return Value=SCREEN TYPE () 


SCREEN WIDTH() 
This command will return an integer value of the current screen width. 


SYNTAX: 
Return Value=SCREEN WIDTH () 


SCREEN HEIGHT() 
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This command will return an integer value of the current screen height. 


SYNTAX: 
Return Value=SCREEN HEIGHT () 


SCREEN DEPTH() 

This command will return an integer value of the current screen depth. The depth value indicates the 
number of bits used to make up a color for the screen and therefore reveal how many colors in total can be 
used by the screen. A value of 16 indicates it is a 16-bit screen and uses 32000 colors, whereas a 32-bit 
screen uses 16 million colors. 


SYNTAX: 
Return Value=SCREEN DEPTH () 


SCREEN FPS() 
This command will get the current frames per second to measure how many times the screen is refreshed 
each second. The integer value returned is measured in units of 1/1000th of a second. 


SYNTAX: 
Return Value=SCREEN FPS () 
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Bitmap Command Set 


Bitmap files that are stored in the BMP format can be loaded using the bitmap command set. You can load 
or create up to 32 bitmaps for use in your programs. Bitmaps are mainly used to hide graphics off-screen 
for storage and manipulation. You are also able to copy, mirror, flip, blur, fade and save your bitmaps to 
give you full control over graphics handling. 


LOAD BITMAP 

This command loads a BMP bitmap file to the screen. You can optionally provide a Bitmap Number between 
1 and 32. Once you have loaded the bitmap file successfully, you can use the specified bitmap number to 
modify and manage the bitmap. The bitmap number should be specified using an integer value. 


SYNTAX: 
LOAD BITMAP Filename 
LOAD BITMAP Filename, Bitmap Number 


CREATE BITMAP 

This command will create a blank bitmap of a specified size. The size of the bitmap is only limited by the 
amount of system memory available. When you create a bitmap, it becomes the current bitmap. All drawing 
operations will be re-directed to the current bitmap and away from the screen. You can use the SET 
CURRENT BITMAP command to restore drawing operations to the screen. The parameters should be 
specified using integer values. 


SYNTAX: 
CREATE BITMAP Bitmap Number, Width, Height 


SET CURRENT BITMAP 

This command will set the current bitmap number for all drawing operations.. Use this command if you wish 
to draw, paste and extract images from the bitmap. Setting the current bitmap to zero points all drawing 
operations to the screen. The parameter should be specified using an integer value. 


SYNTAX: 
SET CURRENT BITMAP Bitmap Number 


COPY BITMAP 

This command will copy the contents of one bitmap into another bitmap providing the destination bitmap is 
not smaller than the first. The command requires at least a source and destination bitmap. You can 
optionally specify a source area to be copied from and a destination area to be copied to within each 
bitmap. If the size of the two areas differ, the source data will be rescaled. 


SYNTAX: 
COPY BITMAP From-Bitmap, To-Bitmap 
COPY BITMAP From-Bitmap, Left, Top, Right, Bottom, To-Bitmap, Left, Top, Right, Bottom 


MIRROR BITMAP 
This command will mirror the contents of the specified bitmap horizontally. The parameter should be 
specified using an integer value. 


SYNTAX: 
MIRROR BITMAP Bitmap Number 


FLIP BITMAP 
This command will flip the contents of the specified bitmap vertically. The parameter should be specified 
using an integer value. 


SYNTAX: 
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FLIP BITMAP Bitmap Number 


FADE BITMAP 

This command will fade the contents of a specified Bitmap. You must specify a fade value that sets the level 
of fading from zero which fades the bitmap completely to black, up to 100 which does not fade the bitmap 
at all. Fade operations are slow and the completion time depends on the size of the bitmap. The parameters 
should be specified using integer values. 


SYNTAX: 
FADE BITMAP Bitmap Number, Fade Value 


BLUR BITMAP 

This command will blur the contents of a specified Bitmap. You must specify a blur value from 1 to 6 to 
provide the intensity of the blurring. A blur value of 1 will perform mild blurring, up to a value of 6 that 
causes severe blurring. The greater the intensity of blurring, the longer it takes to perform. The time it takes 
to blur a bitmap is also dependent on the size of the bitmap. The parameters should be specified using 
integer values. 


SYNTAX: 
BLUR BITMAP Bitmap Number, Blur Value 


SAVE BITMAP 

This command will save the contents of the screen to a bitmap file. You can optionally provide a bitmap 
number to save the contents of a bitmap. Files are saved out in the BMP format. The bitmap number should 
be specified using an integer value. 


SYNTAX: 
SAVE BITMAP Filename 
SAVE BITMAP Filename, Bitmap Number 


DELETE BITMAP 
This command will delete a specified Bitmap. Deleting bitmaps that are no longer used greatly improves 
system performance. The parameter should be specified using an integer value. 


SYNTAX: 
DELETE BITMAP Bitmap Number 


BITMAP EXISTS() 
This command will return a one if the specified bitmap exists, otherwise zero is returned. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=BITMAP EXIST (Bitmap Number) 


CURRENT BITMAP() 

This command will return an integer value of the current bitmap number being used. If this value is zero, 
the screen is the current bitmap and drawing operations are performed on the visible screen. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=CURRENT BITMAP () 


BITMAP WIDTH() 

This command will return an integer value of the width of the current bitmap. You can optionally provide a 
bitmap number to return the width of a specified bitmap. The parameter should be specified using an 
integer value. 
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SYNTAX: 
Return Value=BITMAP WIDTH() 
Return Value=BITMAP WIDTH (Bitmap Number) 


BITMAP HEIGHT() 

This command will return an integer value of the height of the current bitmap. You can optionally provide a 
bitmap number to return the height of a specified bitmap. The parameter should be specified using an 
integer value. 


SYNTAX: 
Return Value=BITMAP HEIGHT () 
Return Value=BITMAP HEIGHT (Bitmap Number) 


BITMAP DEPTH() 

This command will return an integer value of the color bit-depth of the current bitmap. You can optionally 
provide a bitmap number to return the color bit-depth of a specified bitmap. color bit-depths represent the 
maximum amount of colors the bitmap can hold. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=BITMAP DEPTH () 
Return Value=BITMAP DEPTH (Bitmap Number) 


BITMAP MIRRORED() 

This command will return a one of the current bitmap has been mirrored, otherwise zero is returned. You 
can optionally provide a bitmap number to check whether a specified bitmap has been mirrored. The 
parameter should be specified using an integer value. 


SYNTAX: 
Return Value=BITMAP MIRRORED () 
Return Value=BITMAP MIRRORED (Bitmap Number) 


BITMAP FLIPPED() 

This command will return a one of the current bitmap has been flipped, otherwise zero is returned. You can 
optionally provide a bitmap number to check whether a specified bitmap has been flipped. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=BITMAP FLIPPED() 
Return Value=BITMAP FLIPPED(Bitmap Number) 
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Sprite Command Set 


You are able to store over sixty thousand sprite objects at any one time. Sprites allow you to place images 
on the screen. The images can be animated and moved around the screen without disturbing the 
background bitmap, making them ideal for game sprites in traditional 2D games. You are also able to flip, 
mirror, scale and stretch your sprites for enhanced visual effect in your programs. 


SPRITE 

This command will set the position and image number of the specified sprite. Providing you are using a valid 
image number from a previous call to the GET IMAGE command, and the position of the sprite is in the 
screen area, you will see your sprite displayed. You can move your sprite by calling the sprite command 
with new position coordinates. You can animate your sprite by calling this command with different image 
numbers to create the effect of animation. You are able to have over sixty thousand sprites on the screen at 
any one time, but it is advisable to restrict yourself to a few hundred sprites for speed critical programs. The 
parameters should be specified using integer values. 


SYNTAX: 
SPRITE Sprite Number, X, Y, Image Number 


SET SPRITE 

This command will set whether the specified sprite restores its background and whether background 
transparency is ignored. If the backsave state is set to zero, the sprite will not restore its background and 
leave a trail as it moves. If the transparency state is set to zero, the sprite will not treat black as a 
transparent color. A transparent color in the sprite image does not write to the screen. If this feature is 
disabled, the sprite would appear as though drawn inside a black rectangle where transparency had 
previously been used. Both states are set to one as these are the most common setting. If you to set the 
backsave state to zero, it is your responsibility to clear or paste the background each time the sprite is 
moved or animated. The sprite number should be specified using an integer value. The backsave and 
transparency states should be specified as either zero or one. 


SYNTAX: 
SET SPRITE Sprite Number, BackSave State, Transparency State 


SIZE SPRITE 

This command will expand or shrinks the specified sprite according to the size values provided. You must 
specify both a horizontal and vertical scale when resizing sprites. The size values must be greater than zero 
of the command will fail. The parameters should be specified using integer values. 


SYNTAX: 
SIZE SPRITE Sprite Number, X-Size Value, Y-Size Value 


SCALE SPRITE 

This command will expand or shrinks the specified sprite according to the scale value provided. If the scale 
value is zero, the sprite will disappear. If the scale value is 100, the sprite will be set to its original size. If 
the scale value is set to 200, the size of the sprite will double. The parameters should be specified using 
integer values. 


SYNTAX: 
SCALE SPRITE Sprite Number, Scale Value 


STRETCH SPRITE 

This command will expand or shrinks the specified sprite according to the scale values provided. You must 
specify both a horizontal and vertical scale when stretching sprites. If the scale value is zero, the sprite will 
disappear. If the scale value is 100, the sprite will be set to its original size. If the scale value is set to 200, 
the size of the sprite will double. The parameters should be specified using integer values. 
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SYNTAX: 
STRETCH SPRITE Sprite Number, X-Scale Value, Y-Scale Value 


PASTE SPRITE 

This command will paste the sprite image to the screen, at the specified coordinates. The sprite image 
pasted to the screen is identical to the current state of the sprite, taking into account scaling, flipping and 
mirroring. The parameters should be specified using integer values. 


SYNTAX: 
PASTE SPRITE Sprite Number, X, Y 


MIRROR SPRITE 
This command will mirror the image of the sprite horizontally. The image itself is untouched, but the 
specified sprite will be drawn in reverse. The parameter should be specified using an integer value. 


SYNTAX: 
MIRROR SPRITE Sprite Number 


FLIP SPRITE 
This command will vertically flip the visible image of the specified sprite. The image itself is untouched, but 
the specified sprite will be drawn upside down. The parameter should be specified using an integer value. 


SYNTAX: 
FLIP SPRITE Sprite Number 


OFFSET SPRITE 

This command will shift the position of the drawn image without affecting the coordinate of the specified 
sprite. You can use this command to change the visible sprite in relation to the coordinates you use to 
position it. The parameters should be specified using integer values. 


SYNTAX: 
OFFSET SPRITE Sprite Number, X-Offset, Y-Offset 


HIDE SPRITE 
This command will hide the specified sprite. The parameter should be specified using an integer value. 


SYNTAX: 
HIDE SPRITE Sprite Number 


SHOW SPRITE 
This command will show the specified sprite. The parameter should be specified using an integer value. 


SYNTAX: 
SHOW SPRITE Sprite Number 


HIDE ALL SPRITES 
This command will hide all the sprites currently visible. 


SYNTAX: 
HIDE ALL SPRITES 


SHOW ALL SPRITES 
This command will show all the sprites currently invisible. 


SYNTAX: 
SHOW ALL SPRITES 
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DELETE SPRITE 
This command will delete the specified sprite from memory. Deleting unused sprites increases system 
performance. The parameter should be specified using an integer value. 


SYNTAX: 
DELETE SPRITE Sprite Number 


LOAD IMAGE 

This command will load a bitmap file as an image. You must specify an image number between 1 and 
65535. The optional Texture Mode value is used to control the texture capabilities of the image. If you set 
the Texture Mode value to 1 you will load the image directly into Video memory, rather than having the 
system automatically do it later on. If you set the Texture Mode to 2 you will ask that the image be 
compressed when used as a texture. Compressed textures take up less Video memory when used but 
requires special hardware on the card called Hardware Texture Compression. 


It is recommended you don't use compressed textures when using the black transparency option on 3D 
objects that use the texture, as the performance hit is considerable. 


SYNTAX 
LOAD IMAGE Filename String, Image Number 
LOAD IMAGE Filename String, Image Number, Texture Mode 


SAVE IMAGE 
This command will save an image as a bitmap file. You must specify an existing image number between 1 
and 65535. The file must not already exist, otherwise the command will fail. 


SYNTAX: 
SAVE IMAGE Filename String, Image Number 


GET IMAGE 

This command will copy a selected area of the current bitmap. You must specify an image number between 
1 and 65535. Amongst other things, you can use this command to store sequences of image data and 
provide animations for sprites. When images are grabbed, they are stored in memory and do not require the 
bitmap from which the image was taken. The parameters should be specified using integer values. 


The optional Texture Mode value is used to control the texture capabilities of the image. If you set the 
Texture Mode value to 1 you will copy the image directly into Video memory, rather than having the system 
automatically do it later on. If you set the Texture Mode to 2 you will ask that the image be compressed 
when used as a texture. Compressed textures take up less Video memory when used but requires special 
hardware on the card called Hardware Texture Compression. 


It is recommended you don't use compressed textures when using the black transparency option on 3D 
objects that use the texture, as the performance hit is considerable. 


SYNTAX: 
GET IMAGE Image Number, Left, Top, Right, Bottom 
GET IMAGE Image Number, Left, Top, Right, Bottom, Texture Mode 


PASTE IMAGE 

This command will paste the specified image to the screen. Optionally, you can paste images to bitmaps 
using the SET CURRENT BITMAP command. If the optional transparent flag is set to one, all coloured pixels 
of RGB(0,0,0) are not drawn. The parameters should be specified using integer values. 


SYNTAX 
PASTE IMAGE Image Number, X, Y 
PASTE IMAGE Image Number, X, Y, Transparent 


75 


DELETE IMAGE 

This command will delete the specified image from memory. You must not delete images that are being 
used by sprites, otherwise those sprites would disappear. Deleting unused images increases system 
performance. The parameter should be specified using an integer value. 


SYNTAX: 
DELETE IMAGE Image Number 


IMAGE EXIST() 
This command will return a one if the image exists. 


SYNTAX: 
Return Value=IMAGE EXIST(Image Number) 


SPRITE EXIST() 
This command will return a one if the specified sprite exists, otherwise zero is returned. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE EXIST (Sprite Number) 


SPRITE X() 
This command will return an integer value of the current X position of the specified sprite. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE X(Sprite Number) 


SPRITE Y() 
This command will return an integer value of the current Y position of the specified sprite. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE Y(Sprite Number) 


SPRITE IMAGE() 
This command will return an integer value of the image number used by the specified sprite. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE IMAGE (Sprite Number) 


SPRITE WIDTH() 
This command will return an integer value of the width of the specified sprite determined by the width of 
the current image being used. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE WIDTH (Sprite Number) 


SPRITE HEIGHT() 
This command will return an integer value of the height of the specified sprite determined by the height of 
the current image being used. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE HEIGHT (Sprite Number) 


SPRITE SCALE X() 
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This command will return an integer value of the specified sprites horizontal scale. The parameter should be 
specified using an integer value. 


SYNTAX: 
Return Value=SPRITE SCALE X(Sprite Number) 


SPRITE SCALE Y() 
This command will return an integer value of the specified sprites vertical scale. The parameter should be 
specified using an integer value. 


SYNTAX: 
Return Value=SPRITE SCALE Y(Sprite Number) 


SPRITE MIRRORED() 
This command will return a one if the specified sprite has been mirrored horizontally, otherwise zero will be 
returned. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE MIRRORED (Sprite Number) 


SPRITE FLIPPED() 
This command will return a one if the specified sprite has been flipped vertically, otherwise zero will be 
returned. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE FLIPPED(Sprite Number) 


SPRITE OFFSET X() 
This command will return an integer value of the current amount of X shift applied to the specified sprite. 
The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE OFFSET X(Sprite Number) 


SPRITE OFFSET Y() 
This command will return an integer value of the current amount of Y shift applied to the specified sprite. 
The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=SPRITE OFFSET Y (Sprite Number) 


SPRITE HIT() 

This command will return a one if the specified sprite has impacted against the target sprite specified. If a 
target sprite has not been specified and a value of zero have been used, this command will return the sprite 
number of any sprite impacting against it. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=SPRITE HIT(Sprite Number, Target Sprite Number) 


SPRITE COLLISION() 

This command will return a one if the specified sprite is overlapping the target sprite specified. If a target 
sprite has not been specified and a value of zero have been used, this command will return the sprite 
number of any sprite overlapping it. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=SPRITE COLLISION (Sprite Number, Target Sprite Number) 
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Sound Command Set 


Sound files that are stored in the WAV format can be loaded using the sound command set. You can store 
over a thousand sounds at any one time, and the number you can play simultaneously is limited to the 
power of your sound card. Most sounds cards today allow you to mix an unlimited number of sounds 
allowing every sound to be played simultaneously! Sounds can be loaded as 3D sounds or normal sounds. 
3D sounds allow the sound to be placed in 3D, perfect for 3D games. All sounds can be played, looped, 
paused and adjusted in speed and volume. 


LOAD SOUND 
This command will load a WAV sound file into the specified Sound Number. The Sound Number must be an 
integer value. 


SYNTAX: 
LOAD SOUND Filename, Sound Number 
LOAD SOUND Filename, Sound Number, Priority Flag 


LOAD 3DSOUND 

This command will load a WAV sound file into the specified Sound Number as a special 3D sound. 3D 
sounds can be placed in 3D space and heared through the virtual ears of a listener. The listener can also be 
placed anywhere in 3D space creating true surround sound capabilities. The Sound Number must be an 
integer value. 


SYNTAX: 
LOAD 3DSOUND Filename, Sound Number 


CLONE SOUND 

This command will clone a sound into the specified Destination Sound Number. Cloning a sound will create a 
new sound that can be played like any other loaded sound, but uses the same WAV data of the original 
sound. The advantage of sound cloning is that one hundred sounds could be used with only a single 
instance of the sound data stored in memory. The Sound Number must be an integer value. 


SYNTAX: 
CLONE SOUND Destination Sound Number, Source Sound Number 


PLAY SOUND 
This command will play the specified Sound Number. An optional parameter allows you to specify a start 
position in bytes that skips the initial part of the sample to be played. 


SYNTAX: 
PLAY SOUND Sound Number 
PLAY SOUND Sound Number, Start Position 


LOOP SOUND 
This command will play and loop the specified Sound Number continuously. Optional parameters allow you 
to specify a start position, end position and initial position in bytes that a looping sound will use as it plays. 


SYNTAX: 
LOOP SOUND Sound Number 
LOOP SOUND Sound Number, Start Position 
LOOP SOUND Sound Number, Start Position, End Position 
LOOP SOUND Sound Number, Start Position, End Position, Initial Position 


STOP SOUND 
This command will stop the specified Sound Number if it is playing. 
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SYNTAX: 
STOP SOUND Sound Number 


RESUME SOUND 
This command will resume the specified Sound Number after it has been paused. 


SYNTAX: 
RESUME SOUND Sound Number 


PAUSE SOUND 
This command will pause the specified Sound Number whilst it is playing. 


SYNTAX: 
PAUSE SOUND Sound Number 


SET SOUND PAN 

This command will set the pan of standard sounds by locating it between the left and right speakers. A 
negative value will move the sound to the left speaker, a positive value will move it to the right. Sound 
panning does not work with 3D sounds. The pan value must be an integer value between -100 and 100. 


SYNTAX: 
SET SOUND PAN Sound Number, Pan Value 


SET SOUND SPEED 
This command will set the frequency used by the specified Sound Number. Decibel frequency ranges from 
100 to 100,000 and must be specified using an integer value. 


SYNTAX: 
SET SOUND SPEED Sound Number, Frequency Value 


SET SOUND VOLUME 
This command will set the percentage volume used by the specified Sound Number. 
The volume value should use an integer value. 


SYNTAX: 
SET SOUND VOLUME Sound Number, Volume Value 


DELETE SOUND 
This command will delete the specified sound previously loaded into Sound Number. 


SYNTAX: 
DELETE SOUND Sound Number 


RECORD SOUND 

This command will start recording a sound from the microphone. You can optionally specify an additional 
integer parameter to record a sound for any amount of seconds. The default if this parameter is not 
specified is five seconds of recording. You must specify an empty sound number using an integer value. 


SYNTAX: 
RECORD SOUND Sound Number, Length in Seconds 


STOP RECORDING SOUND 
This command will stop recording a sound previously started using RECORD SOUND. 


SYNTAX: 
STOP RECORDING SOUND 
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SAVE SOUND 
This command will save a sound previously stored in the Sound Number to a file. The sound file will be 
stored in the WAV format and the specified file should ideally end with “.WAV”. 


SYNTAX: 
SAVE SOUND Filename, Sound Number 


SET EAX 

This command will set the environmental audio effect that all sounds will use. The Effect Value must be a 
value between 0 and 26. A value of zero deactivates EAX, where one of the following values activates one of 
the preset effects. 


1=GENERIC 14=STONECORRIDOR 
2=PADDEDCELL 15=ALLEY 
3=ROOM 16=FOREST 
4=BATHROOM 17=CITY 
5=LIVINGROOM 18=MOUNTAINS 
6=STONEROOM 19=QUARRY 
7=AUDITORIUM 20=PLAIN 
8=CONCERTHALL 21=PARKINGLOT 
9=CAVE 22=SEWERPIPE 
10=ARENA 23=UNDERWATER 
11=HANGAR 24=DRUGGED 
12=CARPETEDHALLWAY 25=DIZZY 
13=HALLWAY 26=PSYCHOTIC 
SYNTAX: 


SET EAX Effect Value 


POSITION SOUND 
This command will position the specified 3D sound in 3D space. The 3D sounds you hear are calculated 
based on the position of the sound and the listener. 


SYNTAX: 
POSITION SOUND Sound Number, X, Y, Z 


POSITION LISTENER 
This command will position the listener in 3D space. The 3D sounds you hear are calculated based on the 
position of the sound and the listener. 


SYNTAX: 
POSITION LISTENER X, Y, Z 


ROTATE LISTENER 
This command will set the direction of the listener. The 3D sounds being played would sound different 
based on which direction the listener was facing. 


SYNTAX: 


ROTATE LISTENER X, Y, Z 


SOUND EXIST() 
This command will return an integer value of one if the specified Sound Number exists, otherwise zero will 
be returned. 


SYNTAX: 
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Return Value=SOUND EXIST(Sound Number) 


SOUND TYPE() 
This command will return an integer value of one if the specified Sound Number is a special 3D sound, 
otherwise zero will be returned. 


SYNTAX: 
Return Value=SOUND TYPE(Sound Number) 


SOUND PLAYING() 
This command will return an integer value of one if the specified Sound Number is playing, otherwise zero 
will be returned. 


SYNTAX: 
Return Value=SOUND PLAYING (Sound Number) 


SOUND LOOPING() 
This command will return an integer value of one if the specified Sound Number is looping, otherwise zero 
will be returned. 


SYNTAX: 
Return Value=SOUND LOOPING (Sound Number) 


SOUND PAUSED() 
This command will return an integer value of one if the specified Sound Number is paused, otherwise zero 
will be returned. 


SYNTAX: 
Return Value=SOUND PAUSED(Sound Number) 


GET SOUND PAN() 
This command will return the current pan value of the specified Sound Number. 


SYNTAX: 
Return Value=GET SOUND PAN(Sound Number) 


GET SOUND SPEED() 
This command will return the current frequency of the specified Sound Number. 


SYNTAX: 
Return Value=GET SOUND SPEED(Sound Number) 


GET SOUND VOLUME() 
This command will return the current percentage volume of the specified Sound Number. 


SYNTAX: 
Return Value=GET SOUND VOLUME (Sound Number) 


SOUND POSITION X() 
This command will return the current X position of the 3D sound specified by Sound Number. 


SYNTAX: 
Return Value=SOUND POSITION X(Sound Number) 


SOUND POSITION Y() 
This command will return the current Y position of the 3D sound specified by Sound Number. 
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SYNTAX: 
Return Value=SOUND POSITION Y(Sound Number) 


SOUND POSITION Z() 
This command will return the current Z position of the 3D sound specified by Sound Number. 


SYNTAX: 
Return Value=SOUND POSITION Z(Sound Number) 


LISTENER POSITION X() 
This command will return the current X position of the listener. 


SYNTAX: 
Return Value=LISTENER POSITION X(Sound Number) 


LISTENER POSITION Y() 
This command will return the current Y position of the listener. 


SYNTAX: 
Return Value=LISTENER POSITION Y(Sound Number) 


LISTENER POSITION Z() 
This command will return the current Z position of the listener. 


SYNTAX: 
Return Value=LISTENER POSITION Z(Sound Number) 


LISTENER ANGLE X() 
This command will return the current X angle of the listeners direction. 


SYNTAX: 
Return Value=LISTENER ANGLE X(Sound Number) 


LISTENER ANGLE Y() 
This command will return the current Y angle of the listeners direction. 


SYNTAX: 
Return Value=LISTENER ANGLE Y (Sound Number) 


LISTENER ANGLE Z() 
This command will return the current Z angle of the listeners direction. 


SYNTAX: 
Return Value=LISTENER ANGLE Z(Sound Number) 
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Music Command Set 


Music files that are stored in the MIDI format can be loaded using the music command set. You can store 
up to 32 music scores, but only one music score can be played at any one time. Music can be played or 
looped indefinitely and paused at any time. 


LOAD MUSIC 
This command will load a MIDI music file into the specified music number. The music number should be an 
integer value. 


SYNTAX: 
LOAD MUSIC Filename, Music Number 


LOAD CDMUSIC 

This command will play CD Audio music stored on your CD. The CD Audio track must be specified and 
loaded before it can be played. Only one CD Audio track can be loaded and played at any one time. To play 
a new track, you must delete a previously loaded track before loading the new one. The parameters must 
be specified using integer values. 


SYNTAX 


LOAD CDMUSIC Track Number, Music Number 


PLAY MUSIC 
This command will play the specified music number. 


SYNTAX: 
PLAY MUSIC Music Number 


LOOP MUSIC 
This command will play and loop the specified music continuously. 


SYNTAX: 
LOOP MUSIC Music Number 


STOP MUSIC 
This command will stop the specified music number if it is playing. 


SYNTAX: 
STOP MUSIC Music Number 


PAUSE MUSIC 
This command will pause the specified music number if it is playing. 


SYNTAX: 
PAUSE MUSIC Music Number 


RESUME MUSIC 
This command will resume the specified music number if it currently paused. 


SYNTAX: 
RESUME MUSIC Music Number 


DELETE MUSIC 
This command will delete the specified music previously loaded into a music number. 
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SYNTAX: 
DELETE MUSIC Music Number 


MUSIC EXIST() 
This command will return an integer value of one if the specified music exists, otherwise zero is returned. 


SYNTAX: 
Return Value=MUSIC EXIST (Music Number) 


MUSIC PLAYING() 
This command will return an integer value of one if the specified music is playing, otherwise zero is 
returned. 


SYNTAX: 
Return Value=MUSIC PLAYING (Music Number) 


MUSIC LOOPING() 
This command will return an integer value of one if the specified music is looping, otherwise zero is 
returned. 


SYNTAX: 
Return Value=MUSIC LOOPING (Music Number) 


MUSIC PAUSED() 
This command will return an integer value of one if the specified music is paused, otherwise a zero is 
returned. 


SYNTAX: 
Return Value=MUSIC PAUSED (Music Number) 
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Animation Command Set 


Animation files that are stored in the AVI format can be loaded and played using the animation command 
set. Animations can be used to provide video playback and cut sequences in your programs. Animations can 
also contain sound. You are able to load and play up to 32 animations simultaneously. Each animation can 
be placed and resized anywhere on the screen. 


LOAD ANIMATION 

This command loads an AVI animation file into the specified animation number. You must specify an 
Animation Number between 1 and 32. Once you have loaded the animation file successfully, you can use 
the specified animation number to place, play and stop the animation. 


SYNTAX: 
LOAD ANIMATION Filename, Animation Number 


PLAY ANIMATION 

This command will play an animation on the screen or to the current Bitmap. By default, animations are 
played to the screen. You must provide an Animation Number of a previously loaded animation file. You can 
optionally provide either one or two sets of X and Y Coordinates to place and resize the animation anywhere 
on the screen. 


SYNTAX: 
PLAY ANIMATION Animation Number 
PLAY ANIMATION Animation Number, X, Y 
PLAY ANIMATION Animation Number, X, Y, X, Y 
PLAY ANIMATION Animation Number, Bitmap Number, X, Y, X, Y 


LOOP ANIMATION 
This command plays the specified animation on the screen or to the current Bitmap, and repeats the 
animation continuously. You must provide an Animation Number of a previously loaded animation file. 


SYNTAX: 
LOOP ANIMATION Animation Number 
LOOP ANIMATION Animation Number, Bitmap Number, X, Y, X, Y 


PLACE ANIMATION 
This command redefines the drawing area of a previously loaded animation. Using this command, 
animations can be stretched, shrunk or moved across the screen even while the animation is playing. 


SYNTAX: 
PLACE ANIMATION Animation Number, X, Y, X, Y 


PAUSE ANIMATION 
This command will pause the specified animation if it is playing. 


SYNTAX: 
PAUSE ANIMATION Animation Number 


RESUME ANIMATION 
This command resumes the specified animation if it is currently paused. 


SYNTAX: 
RESUME ANIMATION Animation Number 


STOP ANIMATION 
This command stops the specified animation if it is playing. 
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SYNTAX: 
STOP ANIMATION Animation Number 


DELETE ANIMATION 

This command deletes an animation previously loaded into the specified Animation Number. Deleting 
animations when you have finished with them improves system performance. If the animation is not 
stopped before the animation is deleted, the current frame of the animation remains on the screen or 
bitmap. 


SYNTAX: 
DELETE ANIMATION Animation number 


ANIMATION EXIST() 
This command will return a one if the specified animation exists, otherwise zero is returned. 


SYNTAX: 
Return Value=ANIMATION EXIST (Animation Number) 


ANIMATION PLAYING() 
This command will return a one if the specified animation is playing, otherwise zero is returned. 


SYNTAX: 
Return Value=ANIMATION PLAYING (Animation Number) 


ANIMATION LOOPED() 
This command will return a one if the specified animation is looping, otherwise zero will be returned. 


SYNTAX: 
Return Value=ANIMATION LOOPED (Animation Number) 


ANIMATION PAUSED() 
This command will return a one if the specified animation is paused, otherwise zero is returned. . 


SYNTAX: 
Return Value=ANIMATION PAUSED (Animation Number) 


ANIMATION POSITION X() 
This command will return the topmost position of the specified animation via its X Coordinate. 


SYNTAX: 
Return Value=ANIMATION POSITION X(Animation Number) 


ANIMATION POSITION Y() 
This command will return the topmost position of the specified animation via its Y Coordinate. 


SYNTAX: 
Return Value=ANIMATION POSITION Y (Animation Number) 


ANIMATION WIDTH() 
This command will return the current width of the specified animation. If you have resized the animation 
when playing or placing then the width of the modified animation will be returned. 


SYNTAX: 
Return Value=ANIMATION WIDTH (Animation Number) 


ANIMATION HEIGHT() 
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This command will return the current height of the specified animation. If you have resized the animation 
when playing or placing then the height of the modified animation will be returned. 


SYNTAX: 
Return Value=ANIMATION HEIGHT (Animation Number) 
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Basic 3D Command Set 


3D Object files that are stored in the X format can be loaded using this command set. You are able to store 
over sixty thousand 3D objects at any one time.. Each object can have an infinite number of sub-objects 
known as limbs and an infinite number of textures. Limbs are used to define different parts of your object. 
If the object contains texture references, the textures will be loaded automatically. Not only can objects be 
positioned, rotated and scaled anywhere in your scene, but they can also perform animation if the object 
contains animation data. When using 3D objects, you are only limited by the speed and capacity of your 
machine. 


LOAD OBJECT 

This command loads a 3D model stored in the X file format into the specified 3D object number. You must 
specify an 3D Object Number between 1 and 65535. Once you have loaded the 3D object file successfully, 
you can use the specified 3D object number to position, rotate, scale, animate and manipulate your 3D 
object. The object number should be specified using an integer value. 


When you import a model from an external source, you should be aware of the dimensional size of your 
object. Models that are less than 50 units in size are too small and will appear tiny when loaded. Models 
that exceed several thousand units are too large and may disappear into the back clipping plane. Clipping 
planes define the finite visibility of your 3D world, and range from 1 (nearest to the camera) to 5000 
(furthest point from the camera). You can change this using the SET CAMERA RANGE command. 


If your model file contains texture information, you need to make sure the texture bitmaps are located 
somewhere within the same directory as your model file. You should also be aware that the X file format 
only supports bitmap texture filenames in the 8.3 format. This means your texture filenames should be 
truncated to its first eight characters and end with a '.bmp' extension. 


SYNTAX: 
LOAD OBJECT Filename, Object Number 


DELETE OBJECT 
This command will delete the specified 3D object previously loaded. The parameter should be specified 
using an integer value. 


SYNTAX: 
DELETE OBJECT Object Number 


SET OBJECT 

This command sets the internal properties of a specified 3D object number. You must specify a 3D Object 
Number between 1 and 65535. 

When the wireframe flag is set to 0, the object only shows it's wireframe form. 

When the transparency flag is set to 0, all parts of the object colored black are not drawn to the screen. 


When the cull flag is set to 0, the object will draw polygons normally hidden due to the direction the 
polygon faces. The Filter Flag activates and deactivates texture filtering, which controls the smoothing effect 
of the texture as it is mapped to the object. The Light Flag activates and deactivates the objects sensitivity 
to any lights in the scene. The Fog Flag activates and deactivates the objects sensitivity to fog in the scene. 
The Ambient Flag activates and deactivates the objects sensitivity to ambient light in the scene. The object 
number and flag values should be specified using integer values. 


SYNTAX 
SET OBJECT Object Number, Wireframe, Transparency, Cull 
SET OBJECT Object Number, Wireframe, Transparency, Cull, Filter 
SET OBJECT Object Number, Wireframe, Transparency, Cull, Filter, Light 
SET OBJECT Object Number, Wireframe, Transparency, Cull, Filter, Light, Fog 
SET OBJECT Object Number, Wireframe, Transparency, Cull, Filter, Light, Fog, Ambient 
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MAKE OBJECT 

This command will construct a 3D object from a single mesh and image. The mesh is used as the root limb 
for the 3D object and the image is used as a texture for the object. You do not have to specify an image 
value, but such models will appear white when displayed. The parameters should be specified using integer 
values. 


SYNTAX: 
MAKE OBJECT Object Number, Mesh Number, Image Number 


MAKE OBJECT SPHERE 

This command will construct a 3D object from a sphere mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX: 
MAKE OBJECT SPHERE Object Number, Radius Value 


MAKE OBJECT CUBE 

This command will construct a 3D object from a cube mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX: 
MAKE OBJECT CUBE Object Number, Size Value 


MAKE OBJECT BOX 

This command will construct a 3D object from a box mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX: 
MAKE OBJECT BOX Object Number, Width, Height, Depth 


MAKE OBJECT CYLINDER 

This command will construct a 3D object from a cylinder mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX: 
MAKE OBJECT CYLINDER Object Number, Size Value 


MAKE OBJECT CONE 

This command will construct a 3D object from a cone mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX 


MAKE OBJECT CONE Object Number, Size Value 


MAKE OBJECT PLAIN 

This command will construct a 3D object from a flat mesh. The mesh is used as the root limb for the 3D 
object. The 3D object will be constructed untextured and such models will appear white when displayed. 
The parameters should be specified using integer values. 


SYNTAX: 
MAKE OBJECT PLAIN Object Number, Width Value, Height Value 
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MAKE OBJECT TRIANGLE 

This command will construct a 3D object from values that describe a single triangle mesh. The mesh is used 
as the root limb for the 3D object. The 3D object will be constructed untextured and such models will 
appear white when displayed. The object number should be specified using an integer value and the 3D 
coordinates specified using real values. 


SYNTAX: 
MAKE OBJECT TRIANGLE Object Number, X1, Yl, Zl, X2, Y2, 22, X3, Y3, 23 


APPEND OBJECT 

This command will append all animation data from the 3D object file into the specified object. The new 
animation data will begin from the start frame specified up to the length of the files animation data. Ensure 
that the 3D object being appended uses the same limb names as the original object, otherwise the load will 
fail. The parameters should be specified using integer values. 


SYNTAX: 
APPEND OBJECT Filename, Object Number, Start Frame 


PLAY OBJECT 

These commands will play the animation data contained within the specified 3D object. You can optionally 
play the animation by providing a specified start and end frame. The parameters should be specified using 
integer values. 


SYNTAX: 
PLAY OBJECT Object Number 
PLAY OBJECT Object Number, From Frame 
PLAY OBJECT Object Number, From Frame, End Frame 


LOOP OBJECT 

This command will play and loop the animation data contained within the specified 3D object from the 
beginning. You can optionally play and loop the animation by providing a specified start and end frame. The 
parameters should be specified using integer values. 


SYNTAX: 
LOOP OBJECT Object Number 
LOOP OBJECT Object Number, From Frame 
LOOP OBJECT Object Number, From Frame, End Frame 


STOP OBJECT 
This command will stop the animation in a specified 3D object. The parameter should be specified using an 
integer value. 


SYNTAX: 
STOP OBJECT Object Number 


HIDE OBJECT 

This command will hide the specified 3D object from view. You can substantially increase the performance 
of your 3D program if you hide objects when ever possible. The contents of a room behind a closed door 
can be hidden for as long as the door remains closed, allowing your program to run much faster and 
improve overall performance. The parameter should be specified using an integer value. 


SYNTAX: 
HIDE OBJECT Object Number 


SHOW OBJECT 
This command will reveal a specified 3D object that was previously hidden. The parameter should be 
specified using an integer value. 
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SYNTAX: 
SHOW OBJECT Object Number 


TEXTURE OBJECT 
This command will texture an object using the specified image. The image must not exceed the maximum 
texture size of 256x256. The object and image number must be integer values. 


SYNTAX: 
TEXTURE OBJECT Object Number, Image Number 


SCALE OBJECT 
This command will scale the specified 3D object to stretch or shrink in all three dimensions, using 
percentage scale values. The parameters should be specified using integer values. 


SYNTAX: 
SCALE OBJECT Object Number, X, Y, Z 


COLOR OBJECT 
This command will color the specified 3D object using an RGB colour value. The colour value can be 
specified using the RGB() command. The parameters should be specified using integer values. 


SYNTAX: 
COLOR OBJECT Object Number, Colour Value 


SCROLL OBJECT TEXTURE 

This command will scroll the UV data of the specified object. The UV data controls how a texture is mapped 
onto your object. By scrolling the UV data, you can effectively scroll the texture over your object. The U 
value controls the horizontal shift of the data. The V value controls the vertical shift of the data. The scroll 
effect is perminant. 


SYNTAX: 
SCROLL OBJECT TEXTURE Object Number, U Value, V Value 


SCALE OBJECT TEXTURE 

This command will scale the UV data of the specified object. The UV data controls how a texture is mapped 
onto your object. By scaling the UV data, you can effectively stretch or tile the texture over your object. The 
U value controls the horizontal spread of the data. The V value controls the vertical spread of the data. A U 
or V value of 1 means no scale change. A value of 0.5 will scale the texture by half. A value of 2.0 will 
double the scale of the texture. The scale effect is permanent. 


SYNTAX: 
SCALE OBJECT TEXTURE Object Number, U Value, V Value 


SET OBJECT FRAME 
This command will set the animation frame of the specified 3D object. The object number should be 
specified using an integer value. The frame number should be specified using a real number. 


SYNTAX: 
SET OBJECT FRAME Object Number, Frame Number 


SET OBJECT SPEED 

This command will set the speed of the animation in the specified 3D object. A value of 1 will perform the 
animation at its slowest rate. A value of 100 is the maximum speed setting. The parameters should be 
specified using integer values. 


SYNTAX: 
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SET OBJECT SPEED Object Number, Speed Value 


SET OBJECT INTERPOLATION 

This command will set the percentage of animation frame interpolation in the specified 3D object. 
Interpolation occurs when the animation frame is manually set using the SET OBJECT FRAME command. If 
the interpolation percentage is 100, the transition between frames is instant. When the value is set to 50, it 
would take two cycles to make the transition. You can use interpolation to make extremely smooth 
movements between two different animation frames. The parameters should be specified using integer 
values. 


SYNTAX: 
SET OBJECT INTERPOLATION Object Number, Duration Value 


SET OBJECT ROTATION XYZ 

This command will set the order of rotation to the default behaviour. The angles of rotation will transform 
the object first around the X axis, then the Y axis and finally the Z axis. The parameter should be specified 
using an integer value. 


SYNTAX: 
SET OBJECT ROTATION XYZ Object Number 


SET OBJECT ROTATION ZYX 

This command will reverse the order of rotation for the specified object. The angles of rotation will 
transform the object first around the Z axis, then the Y axis and finally the X axis. The parameter should be 
specified using an integer value. 


SYNTAX: 
SET OBJECT ROTATION ZYX Object Number 


GHOST OBJECT ON 

This command will make the specified 3D object semi-transparent if supported by the current display card. 
This technique is known as alpha-blending and causes the object to appear as a ghost image. The 
parameter should be specified using an integer value. 


SYNTAX: 
GHOST OBJECT ON Object Number 
GHOST OBJECT ON Object Number, Dark Ghosting Flag 


GHOST OBJECT OFF 
This command will deactivate the effect of ghosting on the specified 3D object. The parameter should be 
specified using an integer value. 


SYNTAX: 
GHOST OBJECT OFF Object Number 


FADE OBJECT 

This command will make the specified 3D object fade to the current ambient light level. With ambient light 
set to zero and the object faded using a value of zero, the object will be completely unlit. With a fade value 
of 200 its illumination will be doubled.. With a fade value of 50, the illumination is halved. This technique 
can also be used with a ghosted object to slowly fade an object until completely invisible. The effect of 
fading an object is permanent, so fading an object completely to zero destroys its lighting data forever. The 
parameter should be specified using an integer value. Setting a fade value of zero will permanently remove 
the objects light data. Objects with no light data use the current ambient light level, and will not appear 
black unless the ambient light level is also zero. 


SYNTAX: 
FADE OBJECT Object Number, Fade Value 
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GLUE OBJECT TO LIMB 

This command will attach the specified 3D object to a limb of another 3D object. By attaching an object to 
the limb of another, the objects position, rotation and scale are entirely controlled by the limb. This 
technique can be used to allow a robot arm to easily grab and lift an item, or allow your hero character to 
hold and wear a variety of items. The parameters should be specified using integer values. 


SYNTAX: 
GLUE OBJECT TO LIMB Object Number, Target Object Number, Target Object Limb 


UNGLUE OBJECT FROM LIMB 
This command will detach the specified 3D object from any limb. The parameter should be specified using 
an integer value. 


SYNTAX: 
UNGLUE OBJECT FROM LIMB Object Number 


LOCK OBJECT ON 

This command will lock the specified 3D object to the screen. Locking objects to the screen commands the 
object to completely ignore the cameras influence. A locked object will be positioned as though the camera 
had never been altered from its default orientation. To make locked objects visible, simply set the Z position 
to a significant positive value. The Object Number should be specified using an integer value. 


SYNTAX: 
LOCK OBJECT ON Object Number 


LOCK OBJECT OFF 

This command will unlock the specified 3D object from the screen. Locking objects to the screen commands 
the object to completely ignore the cameras influence. By unlocking a previously locked object, you are 
commanding the object to associate itself with the influence of the camera once again. The Object Number 
should be specified using an integer value. 


SYNTAX: 
LOCK OBJECT OFF Object Number 


SET OBJECT TEXTURE 

This command will set different texture modes used by the specified object. Every texture is painted onto an 
object using an internal set of values called UV data. This data contains a range of real numbers from zero 
to one. Zero specifying the top/left corner of your texture and one being the bottom/right corner of your 
texture. When an object uses UV data greater and less than this range, you are permitted a number of 
texture wrap modes to describe what should happen to paint these areas. Setting the Texture Wrap Mode 
to zero will use the default wrap mode which repeat the pattern of the texture over and over, a mode of 
one will mirror the texture to create a seamless texture pattern and a mode of two will set clamping which 
retains the colour of the last pixel at the textures edge and paint with that throughout the out of range 
area. The Mipmap Generation Flag is used to generate mipmap textures for objects that do not have a 
mipmap. A mipmap is a texture that has many levels of detail, which the object can select and use based on 
the objects distance from the camera. Setting this flag to one will generate a mipmap for the specified 
object. Use integer values to specify the parameters. 


SYNTAX: 
SET OBJECT TEXTURE Object Number, Texture Wrap Mode, Mipmap Generation Flag 


DISABLE OBJECT ZDEPTH 

This command will make the object always appear over other objects in the scene. This command can be 
used to ensure a first person shooter gun does not poke through walls and other geometry when you get 
too close. 


SYNTAX: 
DISABLE OBJECT ZDEPTH Object Number 
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ENABLE OBJECT ZDEPTH 
This command will return object zdepth info to normal, allowing the object to behave like any other object 
in the Z buffer. Use this command to restore your object after calling DISABLE OBJECT ZDEPTH. 


SYNTAX: 
ENABLE OBJECT ZDEPTH Object Number 


OBJECT EXIST() 
This command will return a one if the specified 3D object exists, otherwise zero will be returned. The 
parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT EXIST (Object Number) 


TOTAL OBJECT FRAMES() 
This command will return an integer value of the last known animation frame number of the specified 3D 
object. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=TOTAL OBJECT FRAMES (Object Number) 


OBJECT SIZE() 

This command will return a real number representing of the full unit size of the specified 3D object. The unit 
size can be used to determine whether or not to scale the object for better visibility. Extremely small and 
extremely large objects will both suffer visual clipping when viewed by the camera. As a rule, your objects 
should have a unit size of between 50 and 3000. The finite visibility of the camera has a range of 5000 
units, and objects of a distance greater than this will be clipped. Objects that are so close to the camera 
that they pass behind the camera will also be clipped. The parameter should be specified using an integer 
value. 


SYNTAX: 
Return Value=OBJECT SIZE(Object Number) 


OBJECT POSITION X() 
This command will return a real value X position of the specified 3D object in 3D space. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT POSITION X(Object Number) 


OBJECT POSITION Y() 
This command will return a real value Y position of the specified 3D object in 3D space. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT POSITION Y(Object Number) 


OBJECT POSITION Z() 
This command will return a real value Z position of the specified 3D object in 3D space. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT POSITION Z(Object Number) 


OBJECT ANGLE X() 
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This command will return a real value X angle of the specified 3D object. The parameter should be specified 
using an integer value. 


SYNTAX: 
Return Value=OBJECT ANGLE X(Object Number) 


OBJECT ANGLE Y() 
This command will return a real value Y angle of the specified 3D object. The parameter should be specified 
using an integer value. 


SYNTAX: 
Return Value=OBJECT ANGLE Y(Object Number) 


OBJECT ANGLE Z() 
This command will return a real value Z angle of the specified 3D object. The parameter should be specified 
using an integer value. 


SYNTAX: 
Return Value=OBJECT ANGLE Z(Object Number) 


OBJECT SIZE X() 
This command will return the full unit width of the object. 


SYNTAX: 
Return Value=OBJECT SIZE X(Object Number) 


OBJECT SIZE Y() 
This command will return the full unit height of the object. 


SYNTAX: 
Return Value=OBJECT SIZE Y (Object Number) 


OBJECT SIZE Z() 
This command will return the full unit depth of the object. 


SYNTAX: 
Return Value=OBJECT SIZE Z(Object Number) 


OBJECT VISIBLE() 
This command will return a one if the specified 3D object is visible, otherwise zero will be returned. The 
parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT VISIBLE (Object Number) 


ANIMATION COMMANDS 


SAVE OBJECT ANIMATION 
This command will save all animation data of an object to a file. 


SYNTAX: 
SAVE OBJECT ANIMATION Filename String, Object Number 


APPEND OBJECT ANIMATION 


This command will append an animation from a file to an object. The original model file must be specified as 
the first parameter of this command for this to work. The animation file specifies a file you have previously 
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saved containing animation data. The object number is the object you wish to append animation to and the 
start frame specifies where you would like to add the animation data in the objects current animation data. 
Remember you can only append animation to the end of an objects own animation. 


SYNTAX: 
APPEND OBJECT ANIMATION Model Filename String, Animation File String, Object Number, 
Start Frame Value 


CLEAR ALL OBJECT KEYFRAMES 
This command will clear all the animation from an object. 


SYNTAX: 
CLEAR ALL OBJECT KEYFRAMES Object Number 


CLEAR OBJECT KEYFRAME 
This command will clear the keyframe. A keyframe is a single piece of data that tells the object what it 
looks like at a particular point in the animation timeline. 


SYNTAX: 
CLEAR OBJECT KEYFRAME Object Number, Keyframe Value 


SET OBJECT KEYFRAME 
This command will set the current position of all limbs to an object keyframe. This would be similar to 
taking a snapshot of the object and using it as part of the final animation. 


SYNTAX: 
SET OBJECT KEYFRAME Object Number, Keyframe Value 


OBJECT PLAYING() 
This command will return a one if the specified 3D object is playing its animation, otherwise zero will be 
returned. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT PLAYING (Object Number) 


OBJECT LOOPING() 
This command will return a one if the specified 3D object is looping its animation, otherwise zero will be 
returned. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT LOOPING (Object Number) 


OBJECT FRAME() 
This command will return an integer of the current animation frame of the specified 3D object. The 
parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT FRAME (Object Number) 


OBJECT SPEED() 
This command will return an integer value of the current animation speed of the specified 3D object. The 
parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT SPEED (Object Number) 


OBJECT INTERPOLATION() 
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This command will return an integer of the current animation interpolation percentage of the specified 3D 
object. The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT INTERPOLATION (Object Number) 


STATIC OBJECT COMMANDS 


MAKE STATIC OBJECT 

This command will construct a static object from an existing 3D object and re-create it at the existing 
objects position. Static object cannot be moved or changed in anyway once created and are typically used 
to create large scenary constructions for your 3D worlds. Setting the optional Occlusion Mode value to one 
will specify the static object as one that can obscure other objects, thus removing them from the rendering 
list and increasing performance. Any static objects using this mode generates an invisible rectangular 
bounding box. This has the advantage of speed, but the disadvantage of reduced accuracy. Be sure to keep 
objects you are using for occlusion as cube shaped as possible, otherwise you may notice objects being 
removed from view that are not entirely hidden by the static object. A Static object should be created from 
a specified object that contains no more than 2000 vertices, otherwise a slight performance hit could occur. 
A specified object will also loose its additional visual properties such as ghosting and transparency when 
added. The parameter(s) should be specified using an integer value. 


SYNTAX: 
MAKE STATIC OBJECT Object Number 
MAKE STATIC OBJECT Object Number, Occlusion Mode 


DELETE STATIC OBJECTS 

This command will delete all static objects from the 3D space. Static object are special objects that cannot 
be moved or changed in anyway once created and are typically used to create large scenery constructions 
for your 3D worlds. 


SYNTAX: 
DELETE STATIC OBJECTS 


MAKE STATIC COLLISION BOX 

This command will create an invisible collision zones within the static world data. Once defined, you can use 
the GET STATIC COLLISION HIT command to detect whether another dynamically specified box area 
collides with this one. This command is ideally used to define solid areas within your 3D world, and 
preferably in combination with your static object geometry. 


SYNTAX: 
MAKE STATIC COLLISION BOX x1,y1,z21,x2,y2,z2 


SET STATIC OBJECTS TEXTURE 

This command will set different texturing for static objects. The texture wrap mode value can be specified 
as zero for normal wrap mode, one for mirror mode and two for clamp mode. Mirror mode will mirror the 
texture data when the UV data exceeds its boundary, whereas clamp will retain the last texel colour. 


SYNTAX: 
SET STATIC OBJECTS TEXTURE Texture Wrap Mode 


DISABLE STATIC OCCLUSION 
This command will deactivate the use of static occlusion. 


SYNTAX: 
DISABLE STATIC OCCLUSION 


ENABLE STATIC OCCLUSION 
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This command will activate the use of static occlusion. 


SYNTAX: 
ENABLE STATIC OCCLUSION 


SAVE STATIC OBJECTS 
This command will save all static object data to a file. 


SYNTAX: 
SAVE STATIC OBJECTS Filename 


LOAD STATIC OBJECTS 
This command will load all static object data from a file. This command will only load static object data 
previously saved with the SAVE STATIC OBJECTS command. 


SYNTAX: 
LOAD STATIC OBJECTS Filename 


ATTACH OBJECT TO STATIC 

This command will temporarily attach an object to the static world. The advantage of this is that you can 
store all your dynamic objects in the static scene when they are inactive and not required to move or 
animate. This technique increases the speed of your 3D world as static objects render faster than dynamic 
ones. 


SYNTAX: 
ATTACH OBJECT TO STATIC Object Number 


DETACH OBJECT FROM STATIC 
This command will restore objects to normal by removing it as a static object. 


SYNTAX: 
DETACH OBJECT FROM STATIC Object Number 


GET STATIC COLLISION HIT() 

You can use this command to detect whether a specified area within your 3D world is touching a static 
collision box. By specifying old and recent positions of the specified area, this command not only returns a 
one if a collision has occurred, but fills the get static collision x,y and z expressions with adjustment values. 
Applying these values to an object or entity will give the impression of sliding collision. 


SYNTAX: 
Return Value=GET STATIC COLLISION 
HET \( oldx1,oldyl,oldz1,oldx2,oldy2,o0ldz2,nx1,nyl,nz1,nx2,ny2,nz2) 


GET STATIC COLLISION X() 
This command will return sliding data for X. Sliding data is produced when using the GET STATIC 
COLLISION HIT command. 


SY NTAX: 


Return Value=GET STATIC COLLISION X(Object Number) 


GET STATIC COLLISION Y() 
This command will return sliding data for Y. Sliding data is produced when using the GET STATIC 
COLLISION HIT command. 


SYNTAX: 
Return Value=GET STATIC COLLISION Y(Object Number) 
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GET STATIC COLLISION Z() 
This command will return sliding data for Z. Sliding data is produced when using the GET STATIC 
COLLISION HIT command. 


SYNTAX: 
Return Value=GET STATIC COLLISION Z(Object Number) 


3D MOTION AND EULER ROTATION 


POSITION OBJECT 

This command will place the specified 3D object in 3D space. In order to see your 3D object, you must 
ensure the camera is pointing in the right direction and that both camera and 3D object are within 5000 
units from each other. The object number should be specified using an integer value. The 3D Coordinates 
should be specified using real numbers. 


SYNTAX: 
POSITION OBJECT Object Number, X, Y, Z 


FIX OBJECT PIVOT 

This command will fix the current angles of the specified 3D object as the new absolute rotation of the 
model. It is often required to load, rotate and fix models to face a particular direction before using them. 
The object number should be specified using an integer value. 


SYNTAX: 
FIX OBJECT PIVOT Object Number 


ROTATE OBJECT 
This command will rotate the specified 3D object around all three dimensions. The object number should be 
specified using an integer value. The rotation angles should be specified using real numbers. 


SYNTAX: 
ROTATE OBJECT Object Number, X, Y, Z 


XROTATE OBJECT 
This command will rotate the specified 3D object around the X axis dimension. The object number should be 
specified using an integer value. The rotation angle should be specified using a real number. 


SYNTAX: 
XROTATE OBJECT Object Number, X 


YROTATE OBJECT 
This command will rotate the specified 3D object around the Y axis dimension. The object number should 
be specified using an integer value. The rotation angle should be specified using a real number. 


SYNTAX: 
YROTATE OBJECT Object Number, Y 


ZROTATE OBJECT 
This command will rotate the specified 3D object around the Z axis dimension. The object number should 
be specified using an integer value. The rotation angle should be specified using a real number. 


SYNTAX: 
ZROTATE OBJECT Object Number, 2 


POINT OBJECT 


99 


This command will point the specified 3D object towards a point in 3D space. The command sets the current 
direction of the object to face towards this point in space. The object number should be specified using an 
integer value. The 3D Coordinates should be specified using real numbers. 


SYNTAX: 
POINT OBJECT Object Number, X, Y, Z 


MOVE OBJECT 

This command will move the specified 3D object in 3D space. The command uses the current direction of 
the object and moves it using the specified step value. In order to see your 3D object, you must ensure the 
camera is pointing in the right direction and that both camera and 3D object are within 5000 units from 
each other. The object number should be specified using an integer value. The step value should be 
specified using a real number. 


SYNTAX: 
MOVE OBJECT Object Number, Step Value 


FREE FLIGHT ROTATION 


TURN OBJECT LEFT 

This command will rotate an existing 3D object to turn left. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. 

The angle must be specified using a real value. 


SYNTAX: 
TURN OBJECT LEFT Object Number, Angle 


TURN OBJECT RIGHT 

This command will rotate an existing 3D object to turn right. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. The angle must be specified using a real value. 


SYNTAX: 
TURN OBJECT RIGHT Object Number, Angle 


PITCH OBJECT UP 

This command will rotate an existing 3D object to pitch upwards. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. The angle must be specified using a real value. 


SYNTAX: 
PITCH OBJECT UP Object Number, Angle 


PITCH OBJECT DOWN 

This command will rotate an existing 3D object to pitch downwards. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. The angle must be specified using a real value. 


SYNTAX: 
PITCH OBJECT DOWN Object Number, Angle 


ROLL OBJECT LEFT 

This command will rotate an existing 3D object to roll left. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. 


100 


The angle must be specified using a real value. 


SYNTAX 


ROLL OBJECT LEFT Object Number, Angle 


ROLL OBJECT RIGHT 

This command will rotate an existing 3D object to roll right. The rotation is independent of any axis 
orientation and allows free motion. The value of the angle can be positive or negative. The object number 
must be specified using an integer value. The angle must be specified using a real value. 


SYNTAX: 
ROLL OBJECT RIGHT Object Number, Angle 


SET OBJECT TO OBJECT ORIENTATION 
This command will set the specified 3D object to point in the same direction as another 3D object. 
The object numbers must be specified using integer values. 


SYNTAX: 
SET OBJECT TO OBJECT ORIENTATION Destination Object Number, Source Object Number 


SET OBJECT TO CAMERA ORIENTATION 
This command will set the specified 3D object to point in the same direction as the camera. The object 
number must be specified using an integer value. 


SYNTAX: 
SET OBJECT TO CAMERA ORIENTATION Object Number 


COLLISION DETECTION 


SET OBJECT COLLISION ON 
This command will set the specified 3D object to detect for and be detected for any collisions that occur. 
The parameter should be specified using an integer value. 


SYNTAX: 
SET OBJECT COLLISION ON Object Number 


SET OBJECT COLLISION OFF 
This command will set the specified 3D object to ignore and be ignored should any collision occur. The 
parameter should be specified using an integer value. 


SYNTAX: 
SET OBJECT COLLISION OFF Object Number 


MAKE OBJECT COLLISION BOX 

This command will make an object use box collision. If a value of zero is specified for the flag value, the box 
will be deemed to be a non-rotating box and able to generate sliding collision data using the GET OBJECT 
COLLISION X, Y and Z expressions. If the flag value is one, the box is deemed to be a rotated-box and will 
provide more accurate collision feedback as the object rotates. 


SYNTAX: 
MAKE OBJECT COLLISION BOX Object Number,x1,yl,z1,x2,y2,22,flag 


DELETE OBJECT COLLISION BOX 


This command will make an object use standard collision previously defined before the use of the MAKE 
OBJECT COLLISION BOX command. 
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SYNTAX: 
DELETE OBJECT COLLISION BOX Object Number 


SET OBJECT COLLISION TO SPHERES 

This command will set the specified 3D object to use a spherical area for collision detection. An invisible 
collision sphere will be used for every limb in the object. The parameter should be specified using an integer 
value. 


SYNTAX: 
SET OBJECT COLLISION TO SPHERES Object Number 


SET OBJECT COLLISION TO BOXES 
This command will set the specified 3D object to use a box area for collision detection. An invisible collision 
box will be used for every limb in the object. The parameter should be specified using an integer value. 


SYNTAX: 
SET OBJECT COLLISION TO BOXES Object Number 


SET OBJECT COLLISION TO POLYGONS 

This command will set the specified 3D object to use polygon checking for collision detection. Polygon 
detection is much slower that box and sphere detection, but allows you to detect perfect collision between 
complex objects. The parameter should be specified using an integer value. 


SYNTAX: 
SET OBJECT COLLISION TO POLYGONS Object Number 


SET GLOBAL COLLISION ON 
This command will activate the detection of collisions with any two 3D object, irrespective of their individual 
collision settings. 


SYNTAX: 
SET GLOBAL COLLISION ON 


SET GLOBAL COLLISION OFF 
This command will deactivate the influence of global collision. No 3D objects will be able to detect collisions 
with each other, unless the object has individual collision detection active. 


SYNTAX: 
SET GLOBAL COLLISION OFF 


OBJECT COLLISION() 

This command will return a one if the two specified 3D objects are overlapping. If the second object number 
is set to zero, the number of the object overlapping with the first object will be returned as an integer value. 
The parameters should be specified using integer values. 


SYNTAX: 
Return Value=OBJECT COLLISION (Object Number A, Object Number B) 


OBJECT HIT() 

This command will return a one if the two specified 3D objects hit each other. If the second object number 
is set to zero, the number of the object hit by the first object will be returned as an integer value. The 
parameters should be specified using integer values. 


SYNTAX: 
Return Value=OBJECT HIT(Object Number A, Object Number B) 


102 


OBJECT SCREEN X() 

This command will return the current X screen coordinate of the specified 3D object, even if the object is 
not actually within the borders of the screen. You can use this for providing such things as text labels for 
your 3D objects or adding lens flare to a nearby street lamp. The parameter should be specified using an 
integer value. 


SYNTAX: 
Return Value=OBJECT SCREEN X(Object Number) 


OBJECT SCREEN Y() 

This command will return the current Y screen coordinate of the specified 3D object, even if the object is 
not actually within the borders of the screen. You can use this for providing such things as text labels for 
your 3D objects or adding lens flare to a nearby street lamp. The parameter should be specified using an 
integer value. 


SYNTAX: 
Return Value=OBJECT SCREEN Y (Object Number) 


OBJECT IN SCREEN() 

This command will return a value of one if the specified 3D object is wholey or partly visible within the 
screen borders, otherwise zero is returned. Even if the object is behind the camera, it's overall size may 
partially clip the screen area. 

The parameter should be specified using an integer value. 


SYNTAX: 
Return Value=OBJECT IN SCREEN (Object Number) 


GET OBJECT COLLISION X() 

This command will return sliding data for X if the rotated-box flag is zero. The rotated-box flag is set when 
you used the command MAKE OBJECT COLLISION BOX. You must have used the make command in order 
to generate a return value here. 


SYNTAX: 
Return Value=GET OBJECT COLLISION X (Object Number) 


GET OBJECT COLLISION Y() 

This command will return sliding data for Y if the rotated-box flag is zero. The rotated-box flag is set when 
you used the command MAKE OBJECT COLLISION BOX. You must have used the make command in order 
to generate a return value here. 


SYNTAX: 
Return Value=GET STATIC COLLISION Y(Object Number) 


GET OBJECT COLLISION Z() 

This command will return sliding data for Z if the rotated-box flag is zero. The rotated-box flag is set when 
you used the command MAKE OBJECT COLLISION BOX. You must have used the make command in order 
to generate a return value here. 


SYNTAX: 
Return Value=GET STATIC COLLISION Z(Object Number) 


BASIC 3D LIMB COMMANDS 


PERFORM CHECKLIST FOR OBJECT LIMBS 
This command will make a list of all limbs contained in a 3D object. Objects that have been loaded may 
contain hundreds of limbs, and are identified by number. All limbs include an internal limb description that 
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often indicates which part of the overall 3D object it belongs to. You can access the limb description using 
the string item of the checklist when you have performed the check. 


SYNTAX: 
PERFORM CHECKLIST FOR OBJECT LIMBS 


HIDE LIMB 
This command will hide the specified limb within the 3D object. 


SYNTAX: 
HIDE LIMB Object Number, Limb Number 


SHOW LIMB 
This command will show the specified limb within the 3D object previously hidden. The parameters should 
be specified using integer values. 


SYNTAX: 
SHOW LIMB Object Number, Limb Number 


OFFSET LIMB 

This command will change the relative position of the specified limb within the 3D object. The position of 
the limb is always offset from the main coordinates of the 3D object and from any parent limbs. Specifying a 
limb number of zero provides access to the objects own root data, and should not normally be used in this 
way. The object and limb parameters should be specified using integer values. The offset parameters should 
be specified using real numbers. 


SYNTAX: 
OFFSET LIMB Object Number, Limb Number, X, Y, Z 


ROTATE LIMB 

This command will change the rotation of the specified limb within the 3D object. Specifying a limb number 
of zero provides access to the objects own root data, and should not normally be used in this way. The 
object and limb parameters should be specified using integer values. The offset parameters should be 
specified using real numbers. 


SYNTAX: 
ROTATE LIMB Object Number, Limb Number, X, Y, Z 


SCALE LIMB 

This command will change the scale of the specified limb within the 3D object by affecting the percentage 
scale value of all three dimensions. Specifying a limb number of zero provides access to the objects own 
root data, and should not normally be used in this way. The parameters should be specified using integer 
values. 


SYNTAX: 
SCALE LIMB Object Number, Limb Number, X, Y, 2 


ADD LIMB 

This command will create a new limb from a specified mesh and add it to an existing 3D object. Limbs can 
only be added sequentially, so you must ensure you specify a new limb number that immediately follows an 
existing limb. The parameters should be specified using integer values. When a limb is added to a 3D 
object, it will not have a place in the object hierarchy. You can position the limb in the object hierarchy 
using the LINK LIMB command. Do not confuse LINK LIMB with OFFSET LIMB which sets the actual 3D 
position of the limb within the object. 


SYNTAX: 
ADD LIMB Object Number, Limb Number, Mesh Number 
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LINK LIMB 

This command will link a newly created limb to a limb within an existing 3D object. When a limb is 
connected to another, it becomes a child limb that will be affected by the position, rotation and scale of it's 
parent limbs. The parameters should be specified using integer values. 


SYNTAX: 
LINK LIMB Object Number, Limb Child, Limb Parent 


TEXTURE LIMB 

This command will apply an existing image to the limb of a 3D object as a texture. You must create an 
image first using the GET IMAGE command before attempting to texture part of the 3D object. The 
parameters should be specified using integer values. 

Textures need to be of a particular size. The maximum image size you can use as a texture is 256x256. All 
images are ideally square and are divisible by 2. So texture sizes of 2x2, 4x4, 8x8, 16x16, 32x32, 64x64 and 
128x128 are the standard dimensions to use. 


SYNTAX: 
TEXTURE LIMB Object Number, Limb Number, Image Number 


COLOR LIMB 
This command will color the specified limb of a 3D object using an RGB colour value. The parameters must 
be integer values. The RGB color value can be generated by using the RGB command. 


SYNTAX: 
COLOR LIMB Object Number, Limb Number, Color Value 


SCROLL LIMB TEXTURE 
This command will scroll the UV data of the specified limb of the 3D object. The UV data controls how a 
texture is mapped onto your object. By scrolling the UV data, you can effectively scroll the texture over your 
limb. The U value controls the horizontal shift of the data. The V value controls the vertical shift of the data. 
The scroll effect is permanent. 


SYNTAX: 
SCROLL LIMB TEXTURE Object Number, Limb Number, U Value, V Value 


SCALE LIMB TEXTURE 

This command will scale the UV data of the specified limb of the 3D object. The UV data controls how a 
texture is mapped onto your object. By scaling the UV data, you can effectively stretch or tile the texture 
over your object. The U value controls the horizontal spread of the data. The V value controls the vertical 
spread of the data. A U or V value of 1 means no scale change. A value of 0.5 will scale the texture by half. 
A value of 2.0 will double the scale of the texture. The scale effect is permanent. 


SYNTAX 


SCALE LIMB TEXTURE Object Number, Limb Number, U Value, V Value 


LIMB EXIST() 
This command will return a one if the specified 3D object exists, otherwise zero will be returned. 


SYNTAX: 
Return Value=LIMB EXIST(Object Number, Limb Number) 


LIMB OFFSET X() 

This command will return a real number X offset of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The position of the limb is always offset from the positional coordinates of the 3D object itself. 
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SYNTAX: 
Return Value=LIMB OFFSET X(Object Number, Limb Number) 


LIMB OFFSET Y() 

This command will return a real number Y offset of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The position of the limb is always offset from the positional coordinates of the 3D object itself. 


SYNTAX: 
Return Value=LIMB OFFSET Y(Object Number, Limb Number) 


LIMB OFFSET Z() 

This command will return a real number Z offset of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The position of the limb is always offset from the positional coordinates of the 3D object itself. 


SYNTAX: 
Return Value=LIMB OFFSET Z(Object Number, Limb Number) 


LIMB ANGLE X() 

This command will return the real number X angle of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB ANGLE X(Object Number, Limb Number) 


LIMB ANGLE Y() 

This command will return the real number Y angle of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB ANGLE Y(Object Number, Limb Number) 


LIMB ANGLE Z() 

This command will return the real number Z angle of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB ANGLE Z(Object Number, Limb Number) 


LIMB POSITION X() 

This command will return the real number world X position of the specified limb of the 3D object. Specifying 
a limb number of zero provides access to the objects own root data, and should not normally be used in this 
way. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB POSITION X(Object Number, Limb Number) 


LIMB POSITION Y() 

This command will return the real number Y position of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The parameters should be specified using integer values. 
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SYNTAX: 
Return Value=LIMB POSITION Y(Object Number, Limb Number) 


LIMB POSITION Z() 

This command will return the real number Z position of the specified limb of the 3D object. Specifying a limb 
number of zero provides access to the objects own root data, and should not normally be used in this way. 
The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB POSITION Z(Object Number, Limb Number) 


LIMB DIRECTION X() 

This command will return the real number world X angle of the specified limb of the 3D object. Specifying a 
limb number of zero provides access to the objects own root data, and should not normally be used in this 
way. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB DIRECTION X(Object Number, Limb Number) 


LIMB DIRECTION Y() 

This command will return the real number world Y angle of the specified limb of the 3D object. Specifying a 
limb number of zero provides access to the objects own root data, and should not normally be used in this 
way. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB DIRECTION Y(Object Number, Limb Number) 


LIMB DIRECTION Z() 

This command will return the real number world Z angle of the specified limb of the 3D object. Specifying a 
limb number of zero provides access to the objects own root data, and should not normally be used in this 
way. The parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB DIRECTION Z(Object Number, Limb Number) 


LIMB TEXTURE() 

This command will return the integer image number used to texture the specified limb of the 3D object. 
Limbs that have been loaded pre-textured contain internal image data and return an image number of zero. 
The parameters should be specified using integer values. 


SYNTAX 


Return Value=LIMB TEXTURE (Object Number, Limb Number) 


LIMB VISIBLE() 
This command will return a one if the specified 3D object exists, otherwise zero will be returned. The 
parameters should be specified using integer values. 


SYNTAX: 
Return Value=LIMB VISIBLE (Object Number, Limb Number) 


LIMB TEXTURE NAME() 
This command will return the internal name of the limb texture. An object can comprise of many meshes, 
each one textured separately. These mesh and texture pairs are called limbs. 


SYNTAX: 
Return Value=LIMB TEXTURE NAME (Object Number, Limb Number) 
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BASIC 3D MESH COMMANDS 


LOAD MESH 

This command will load a single mesh file into the specified mesh number. A mesh is a wireframe 
description of a 3D shape.. You must use a filename that points to a file that stores 3D mesh data in the X 
file format. The mesh number should be specified using an integer value. 


SYNTAX: 
LOAD MESH Filename, Mesh Number 


DELETE MESH 

This command will delete the specified mesh previously loaded. Deleting unused meshes improves system 
performance. After you have used a mesh to create an object or limb, you are free to delete it. The 
parameter should be specified using an integer value. 


SYNTAX: 
DELETE MESH Mesh Number 


CHANGE MESH 
This command will change the mesh of an object limb. You can use this command to animate an object 
that requires a sequence of fixed static meshes. The parameters must be integer values. 


SYNTAX: 
CHANGE MESH Object Number, Limb Number, Mesh Number 


MAKE MESH FROM OBJECT 
This command will make a single mesh using the entire mesh data of an object. A mesh is a wireframe 
description of a 3D shape. The mesh and object numbers should be specified using integer values. 


SYNTAX: 
MAKE MESH FROM OBJECT Mesh Number, Object Number 


MESH EXIST() 
This command will return a one if the specified mesh exists, otherwise zero will be returned. The parameter 
should be specified using an integer value. 


SYNTAX: 
Return Value=MESH EXIST (Mesh Number) 


LINE OF SIGHT 


STATIC LINE OF SIGHT() 

This command will project a line from Sx,Sy,Sz to Dx,Dy,Dz in order to determine whether it is being 
blocked by static collision areas. The Width determines the thickness of the projected line and the Accuracy 
determines how fine the steps are during the check. The fewer steps means the faster the command, 
whereas greater steps means greater accuracy. If the line is obstructed, this command will return a value 
of one, zero otherwise. 


SYNTAX: 
Return Value = STATIC LINE OF SIGHT (Sx,Sy,Sz,Dx,Dy,Dz,Width, Accuracy) 


STATIC LINE OF SIGHT X() 
This command will return sliding data after the command STATIC LINE OF SIGHT has been used. The X 
position returned is the point of collision from the point of view of the source location. 
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SYNTAX: 
Return Value = STATIC LINE OF SIGHT X() 


STATIC LINE OF SIGHT Y() 
This command will return sliding data after the command STATIC LINE OF SIGHT has been used. The Y 
position returned is the point of collision from the point of view of the source location. 


SYNTAX: 
Return Value = STATIC LINE OF SIGHT Y() 


STATIC LINE OF SIGHT Z() 
This command will return sliding data after the command STATIC LINE OF SIGHT has been used. The Z 
position returned is the point of collision from the point of view of the source location. 


SYNTAX: 
Return Value = STATIC LINE OF SIGHT 2Z() 


MISCELLANEOUS 3D COMMANDS 


BACKDROP ON 

This command will activate a 3D backdrop that fills the visible screen. The backdrop is automatically 
activated the first time any 3D object is created or loaded in order to clear the background screen. The 
backdrop can also be colored, textured and scrolled to create the effects of sky or other background effects. 
If you wish to set-up the backdrop before creating your objects, use this command to activate it. 


SYNTAX: 
BACKDROP ON 


BACKDROP OFF 

This command will deactivate the 3D backdrop preventing it from being drawn to the screen. The backdrop 
is automatically activated the first time any 3D object is created or loaded in order to clear the background 
screen. If you do not wish the backdrop to automatically activate, use this command at the start of your 
program. 


SYNTAX: 
BACKDROP OFF 


COLOR BACKDROP 

This command will COLOR the 3D backdrop in the specified COLOR. You can specify the COLOR of your 
choice by using the RGB command to generate the COLOR value to pass into the command. The parameter 
should be specified using an integer value. 


SYNTAX: 
COLOR BACKDROP COLOR Value 


TEXTURE BACKDROP 

This command will texture the 3D backdrop using the specified image value. To map an image onto the 
backdrop, you can obtain an image using the GET IMAGE command and use the image as a texture. The 
textures are pasted onto the backdrop as two rows of 3 tiles, which create six visible textures that make up 
the backdrop. It is recommended you use seamless textures when texturing the backdrop. The image value 
should be specified using an integer value. 


SYNTAX: 
TEXTURE BACKDROP Image Value 
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SCROLL BACKDROP 

This command will scroll the 3D backdrop using the specified X and Y scroll values. The values represent the 
percentage used to scroll the textures used by the backdrop. The textures are pasted onto the backdrop as 
two rows of 3 tiles, which create six visible textures that make up the backdrop. An X value of 50 will scroll 
the texture across by exactly half, and the result of an X value of 100 is identical to an X value of zero. The 
X and Y values should be specified using integer values. 


SYNTAX: 
SCROLL BACKDROP X Value, Y Value 


DRAW TO FRONT 

This command will set all 2D drawing operations to overwrite any 3D that may be rendering to the screen. 
Though it is not recommended for performance reasons to draw 2D whilst displaying 3D, in cases where it is 
required this command will ensure text, art and other images are placed on top of any 3D graphics. It does 
not, however, prevent these 2D drawings from being overwritten by subsequent cycles of rendered 3D 
graphics. This is the default setting. 


SYNTAX: 
DRAW TO FRONT 


DRAW TO BACK 

This command will set all 2D drawings to be placed behind any 3D that may be rendering to the screen. 
Though it is not recommended for performance reasons to draw 2D whilst displaying 3D, in cases where it is 
required this command will ensure text, art and other images are placed behind any 3D graphics. 


SYNTAX: 
DRAW TO BACK 


SET MIPMAP MODE 
This command will set different mipmap modes. Specifying a value of zero will switch off mipmapping. A 
value of one will use point mipmap mode and a value of two will use linear mipmapping. 


SYNTAX: 
SET MIPMAP MODE Value 


SET NORMALIZATION ON 
This command will normalizes all 'normals' contained in 3D rendering data. The default is OFF in order that 
the original ‘normals’ data is preserved on loading. 


SYNTAX: 
SET NORMALIZATION ON 


SET NORMALIZATION OFF 
This command will deactivate normalization of all 'normals' data. The default is OFF in order that the original 
‘normals’ data is preserved on loading. 


SYNTAX: 
SET NORMALIZATION OFF 


CURVEVALUE() 

This command will return an auto-interpolated value based on a given speed. This command will gradually 
move a number from its current value to a destination value at a certain speed. This command can be used 
to create the technique of controlling a cars velocity as it breaks to a halt. The parameters should be 
specified using real numbers. 


SYNTAX: 
Return Value=CURVEVALUE (Destination Value, Current Value, Speed Value) 
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CURVEANGLE() 

This command will return an auto-interpolated angle based on a given speed. This command will gradually 
move a number from its current value to a destination value at a certain speed. This command can be used 
to create the technique of a camera swinging into position from another location by curving the value of the 
camera angles. The parameters should be specified using real numbers. 

This command differs from the CURVEVALUE() command as this command takes into account the wrapping 
of angles between 0 and 360. 


SYNTAX: 
Return Value=CURVEANGLE (Destination Value, Current Value, Speed Value) 


WRAPVALUE() 

This command will return a value that does not exceed the range of 0 to 360. Where a value is specified 
that exceeds this range, the command will wrap the value around to bring it back within the range. This 
command is best understood by using the number of a clock as a mental picture of how a number wraps. If 
the clock hand points to 11 and is then advanced 2 hours, the number has to wrap from 12 around to 1 to 
keep the cycle going. The parameter should be specified using a real number. 


SYNTAX: 
Return Value=WRAPVALUE (Angle Value) 


NEWXVALUE() 

This command will return a value that represents the new X position of a point in 3D space. This command 
is used in conjunction with NEWYVALUE and NEWZVALUE commands to move from one point in space to 
another point in space based on a specified angle. Rather than using COS/SIN maths, these commands 
simplify the task of moving coordinates within 3D space. The step value specifies how far in the specified 
direction you would like to calculate. The parameters should be specified using real numbers. 


SYNTAX: 
Return Value=NEWXVALUE (Current X Value, Angle Value, Step Value) 


NEWYVALUE() 

This command will return a value that represents the new Y position of a point in 3D space. This command 
is used in conjunction with NEWXVALUE and NEWZVALUE commands to move from one point in space to 
another point in space based on a specified angle. Rather than using COS/SIN maths, these commands 
simplify the task of moving coordinates within 3D space. The step value specifies how far in the specified 
direction you would like to calculate. The parameters should be specified using real numbers. 


SYNTAX: 
Return Value=NEWYVALUE (Current Y Value, Angle Value, Step Value) 


NEWZVALUE() 

This command will return a value that represents the new Z position of a point in 3D space. This command 
is used in conjunction with NEWXVALUE and NEWYVALUE commands to move from one point in space to 
another point in space based on a specified angle. Rather than using COS/SIN maths, these commands 
simplify the task of moving coordinates within 3D space. The step value specifies how far in the specified 
direction you would like to calculate. The parameters should be specified using real numbers. 


SYNTAX: 
Return Value=NEWZVALUE (Current Z Value, Angle Value, Step Value) 


ALPHABLENDING AVAILABLE() 
This command will return an integer value of 1 if the current 3D card supports alpha blending. Alpha 
blending is used to create the effect of 3D semi-transparency used by the GHOST OBJECT command. 


SYNTAX: 
Return Value=ALPHABLENDING AVAILABLE () 
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FILTERING AVAILABLE() 
This command will return an integer value of 1 if the current 3D card supports texture filtering. Texture 
filtering is used to smooth out your textures, creating a slight bluring effect that improves visual quality. 


SYNTAX: 
Return Value=FILTERING AVAILABLE () 


FOG AVAILABLE() 
This command will return an integer value of 1 if the current 3D card supports fogging. Fogging is used to 
create the effect of 3D fog used by the commands FOG ON, FOG DISTANCE and FOG COLOR. 


SYNTAX: 
Return Value=FOG AVAILABLE () 


3DBLIT AVAILABLE() 

This command will return an integer value of 1 if the current 3D card supports fast 2D operations during 3D 
activity. Some graphics cards are designed only for 3D rendering, and perform 2D operations such as GET 
IMAGE much slower than dedicated 2D/3D combination cards. You can use this command to ensure your 
software will run fast on as many 3D cards as possible. 


SYNTAX: 
Return Value=3DBLIT AVAILABLE () 
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Camera 3D Command Set 


The camera acts as the eye through which you see your 3D world. The camera can be angled in any 
direction, pointed towards any location and placed anywhere in your scene with a single command. This 
provides the power to create whatever game perspective you want; ist person, birds-eye, isometric, ground 
up or free-floating. 


POSITION CAMERA 
This command will set the position of the camera in 3D space. The coordinates should be real numbers. 


SYNTAX: 
POSITION CAMERA X, Y, Z 


ROTATE CAMERA 
This command will rotate the camera around its X, Y and Z axis. The angle values should be real numbers. 


SYNTAX: 
ROTATE CAMERA X, Y, Z 


XROTATE CAMERA 
This command will rotate the camera around its X axis. The angle value should be a real number. 


SYNTAX: 
XROTATE CAMERA Angle Value 


YROTATE CAMERA 
This command will rotate the camera around its Y axis. The angle value should be a real number. 


SYNTAX: 
YROTATE CAMERA Angle Value 


ZROTATE CAMERA 
This command will rotate the camera around its Z axis. The angle value should be a real number. 


SYNTAX: 
ZROTATE CAMERA Angle Value 


POINT CAMERA 
This command will point the camera to a point in 3D space. The coordinates should be real numbers. 


SYNTAX: 
POINT CAMERA X, Y, Z 


MOVE CAMERA 
This command will move the camera in the direction it is facing. The step value specifies how far to move 
the camera and should be a real number. 


SYNTAX: 
MOVE CAMERA Step Value 


SET CAMERA RANGE 

This command will set the viewing range of the camera. The Front Value specifies the closest point beyond 
which the camera starts to draw the 3D scene. The Back Value specifies the furthest point beyond which the 
camera stops drawing the 3D scene. The parameters must be specified using real numbers greater than 
zero. The default range starts drawing the 3D scene with a front value of 1 and a back value of 3000. 
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The built-in Z-Buffer ensures that objects closer to the camera obscure objects that are further away. If you 
set a very small Front Value and a very large Back Value, you will notice that objects do not always appear 
behind a closer object. You must ensure that the size of your objects are proportional to the range you 
select for your 3D scene. 


SYNTAX: 
SET CAMERA RANGE Front Value, Back Value 


SET CAMERA VIEW 

This command will set the viewport of the camera. The viewport is the actual area on screen where all 3D is 
drawn. The default viewport area is the entire screen, but can be specified using this command. You must 
specify the screen coordinates using integer values. 


SYNTAX 
SET CAMERA VIEW Left, Top, Right, Bottom 


CLEAR CAMERA VIEW 

This command will clear the viewport of the camera. The viewport is the actual area on screen where all 3D 
is drawn. The default viewport area is the entire screen. You can specify that only the camera viewport be 
cleared using this command. This area can be changed using rhe Set Camera View command. You must 
specify the colour value using an integer value. 


SYNTAX 
CLEAR CAMERA VIEW Colour Value 


SET CAMERA ROTATION XYZ 
This command will reverse the camera rotation order. The cameras normal rotation order is to first rotate 
on the Z axis, then on the Y axis and finally on the X axis. This command reverses this order to XYZ. 


SYNTAX: 
SET CAMERA ROTATION XYZ 


SET CAMERA ROTATION ZYX 
This command will restore the default camera rotation order. The cameras normal rotation order is to first 
rotate on the Z axis, then on the Y axis and finally on the X axis. This command restores the order to ZYX. 


SYNTAX: 
SET CAMERA ROTATION ZYX 


SET CAMERA FOV 
This command will set the field of view for the camera using an Angle value. The default angle is the result 
of the calculation 3.14/2.905. 


SYNTAX: 
SET CAMERA FOV Angle 


SET CAMERA TO FOLLOW 

This command automatically controls the camera to provide a tracking system. By providing the 3D world 
coordinate of the entity you wish to track, and some camera data your camera will automatically update its 
current position each time this command is called. The X, Y, Z and Angle values provide the coordinate to 
track. The Camdist value specifies the required distance between the coordinate and the camera. The 
Camheight value specifies the required height of the camera in 3D space. The Camsmooth value specifies 
the level of smoothing required for the camera, where a value of 1.0 is no smoothing and a value of 100.0 
is lots of smoothing. The Colflag value is a special flag that allows the camera to detect whether it is hitting 
any of the static collision boxes and if set to one will automatically adjust so as not to enter these collision 
areas. 
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SYNTAX: 
SET CAMERA TO FOLLOW X, Y, Z, Angle, Camdist, Camheight, Camsmooth, ColFlag 


AUTOCAM ON 
This command will activate the auto camera which will reposition when a new object is loaded or created. 


SYNTAX: 
AUTOCAM ON 


AUTOCAM OFF 
This command will deactivate the auto camera. The camera will then no longer reposition when a new 
object is loaded or created. 


SYNTAX: 
AUTOCAM OFF 


TURN CAMERA LEFT 

This command will turn the camera left. The rotation is independent of any axis orientation and allows free 
motion. 

The value of the angle can be positive or negative. The angle must be specified using a real value. 


SYNTAX: 
TURN CAMERA LEFT Angle 


TURN CAMERA RIGHT 

This command will turn the camera right. The rotation is independent of any axis orientation and allows free 
motion. 

The value of the angle can be positive or negative. The angle must be specified using 


SYNTAX: 
TURN CAMERA RIGHT Angle 


PITCH CAMERA UP 

This command will pitch the camera upwards. The rotation is independent of any axis orientation and allows 
free motion. The value of the angle can be positive or negative. The angle must be specified using a real 
value. 


SYNTAX: 
PITCH CAMERA UP Angle 


PITCH CAMERA DOWN 

This command will pitch the camera downwards. The rotation is independent of any axis orientation and 
allows free motion. The value of the angle can be positive or negative. The angle must be specified using a 
real value. 


SYNTAX: 
PITCH CAMERA DOWN Angle 


ROLL CAMERA LEFT 
This command will roll the camera left. The rotation is independent of any axis orientation and allows free 
motion. The value of the angle can be positive or negative. The angle must be specified using a real value. 


SYNTAX: 
ROLL CAMERA LEFT Angle 


ROLL CAMERA RIGHT 
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This command will roll the camera right. The rotation is independent of any axis orientation and allows free 
motion. The value of the angle can be positive or negative. The angle must be specified using a real value. 


SYNTAX: 
ROLL CAMERA RIGHT Angle 


SET CAMERA TO OBJECT ORIENTATION 
This command will set the camera to the same direction as the specified 3D object. The object number must 
be an integer value. 


SYNTAX: 
SET CAMERA TO OBJECT ORIENTATION Object Number 


CAMERA POSITION X() 
This command will return the real value X position of the camera in 3D space. 


SYNTAX: 
Return Value=CAMERA POSITION X() 


CAMERA POSITION Y() 
This command will return the real value Y position of the camera in 3D space. 


SYNTAX: 
Return Value=CAMERA POSITION Y() 


CAMERA POSITION Z() 
This command will return the real value Z position of the camera in 3D space. 


SYNTAX: 
Return Value=CAMERA POSITION Z() 


CAMERA ANGLE X() 
This command will return the real value X angle of the camera. 


SYNTAX: 
Return Value=CAMERA ANGLE X() 


CAMERA ANGLE Y() 
This command will return the real value Y angle of the camera. 


SYNTAX: 
Return Value=CAMERA ANGLE Y () 


CAMERA ANGLE Z() 
This command will return the real value Z angle of the camera. 


SYNTAX: 
Return Value=CAMERA ANGLE Z () 
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3D Lighting 


3D Lights are used to illuminate your 3D scenes, creating anything from subtle ambient effects, to bright 
cones of light and shadows. You are able to create up to 7 unique sources of light, each with its own style, 
colour, position and in some cases direction. You can also modify light zero, which is the default illumination 
for an empty scene. 


MAKE LIGHT 

This command will create a new light in the scene. You can create up to 7 new lights, numbered 1 to 7. 
Light zero is the default light and is always present. The light number must be specified using an integer 
value. 


SYNTAX: 
MAKE LIGHT Light Number 


DELETE LIGHT 
This command will delete an existing light from the scene. Light zero is the default light and cannot be 
removed, only hidden. The light number must be specified using an integer value. 


SYNTAX: 
DELETE LIGHT Light Number 


SET POINT LIGHT 

This command will set an existing light to that of a point light. The position is specified using a coordinate in 
3D space. The light number must be specified using an integer value. The coordinate must be specified 
using real values. 


SYNTAX: 
SET POINT LIGHT Light Number, X, Y, Z 


SET SPOT LIGHT 

This command will set an existing light to that of a spot light. The spot light is defined by a constant cone of 
inner light and a gradual fading of light within an outer cone. The inner and outer cones are defined by an 
angle ranging from 0 to 360. 

The light number must be specified using an integer value. The angles must be specified using real values. 


SYNTAX: 
SET SPOT LIGHT Light Number, Inner Angle, Outer Angle 


SET DIRECTIONAL LIGHT 

This command will set an existing light to that of a directional light. The direction is specified using 
directional values assuming that the origin of the light is 0,0,0. The light number must be specified using an 
integer value. The directional values must be specified using real values. A directional coordinate of 0,0,1 
will set a direction of light into the scene. A directional coordinate of 0,-1,0 will set a direction of light 
coming from above. 


SYNTAX: 
SET DIRECTIONAL LIGHT Light Number, X, Y, Z 


SET LIGHT RANGE 
This command will set the range of the light, controlling how far its influence will reach. The default range 
of a light is 3000 units. The range parameter must be specified using a real value. 


SYNTAX: 
SET LIGHT RANGE Light Number, Range Value 
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POSITION LIGHT 

This command will position an existing light within the scene. Only spot lights and point lights can make use 
of this command. The light number must be specified using an integer value. The coordinates must be 
specified using real values. 


SYNTAX: 
POSITION LIGHT Light Number, X, Y, Z 


ROTATE LIGHT 
This command will rotate an existing light within the scene. Only spot lights can make use of this command. 
The light number must be specified using an integer value. The angles must be specified using real values. 


SYNTAX: 
ROTATE LIGHT Light Number, X, Y, Z 


POINT LIGHT 

This command will point an existing light at a location within the scene. Only spot lights and directional 
lights can make use of this command. The light number must be specified using an integer value. The 
coordinates must be specified using real values. 


SYNTAX: 
POINT LIGHT Light Number, X, Y, Z 


COLOR LIGHT() 

This command will color an existing light within the scene. You can specify the color as a single colourvalue 
using the RGB command. Alternatively you can specify the color values individually by providing a red, 
green and blue component value in the range of -255 to 255. The light number and parameters must be 
specified using integer values. You can create dark-light by specifying negative component values for your 
colour. Two uses of dark-light are the creation of smooth shadows and cloud cover effects. 


SYNTAX: 
COLOR LIGHT Light Number, Color Value 
COLOR LIGHT Light Number, Red Value, Green Value, Blue Value 


HIDE LIGHT 
This command will hide an existing light and remove its influence from the scene. 
The light number must be specified using an integer value. 


SYNTAX: 
HIDE LIGHT Light Number 


SHOW LIGHT 
This command will show an existing light within the scene. The light number must be specified using an 
integer value. 


SYNTAX: 
SHOW LIGHT Light Number 


SET LIGHT TO OBJECT POSITION 
This command will position an existing light to the location of another object. 
The parameters must be specified using integer values. 


SYNTAX: 
SET LIGHT TO OBJECT POSITION Light Number, Object Number 


SET LIGHT TO OBJECT ORIENTATION 
This command will rotate an existing light to the orientation of another object. 
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To create the effect of headlamps, two spotlights would each take the rotational orientation of a car. The 
parameters must be specified using integer values. 


SYNTAX: 
SET LIGHT TO OBJECT ORIENTATION Light Number, Object Number 


SET AMBIENT LIGHT 

This command will set the percentage level of ambient light. A setting of 100 provides full illumination and 
no shadow whereas a setting of zero gives no illumination and substantial shadowing on any 3D object. The 
parameter should be specified using an integer value. 


SYNTAX: 
SET AMBIENT LIGHT Light Value 


COLOR AMBIENT LIGHT 
This command will change the current ambient light colour. 


SYNTAX: 
COLOR AMBIENT LIGHT Light Rgb Value 


FOG COMMANDS 


FOG ON 
This command will activate the effect of fogging, if the current display card supports it. All fog color and 
distance settings are safely restored when using this command. 


SYNTAX: 
FOG ON 


FOG COLOR 

This command will set the color of the fogging effect. The parameter should be specified using an integer 
value. The color value can be generated using the RGB command to create over 16 million different colors 
of fog. 


SYNTAX: 
FOG COLOR color Value 


FOG DISTANCE 

This command will set the visible distance of the fog based on the view from the camera. The distance 
value represents the Z depth at which the fog obscures 3D objects. A distance of zero sets the fog to 
obscure the camera entirely. A distance of 5000 places the fog to obscure 3D objects as they are Z clipped 
by the system. A distance greater than 5000 will not obscure distant 3D objects and will allow the objects to 
be visibly clipped. The parameters should be specified using integer values. The parameter should be 
specified using an integer value. 


SYNTAX: 
FOG DISTANCE Distance Value 


FOG OFF 

This command will deactivate the effect of fogging, if the fog has been previously activated using the FOG 
ON command. All fog color and distance settings are safely stored when using this command, allowing a call 
to FOG ON to restore all fog settings. 


SYNTAX: 
FOG OFF 
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LIGHT EXPRESSIONS 


LIGHT EXIST() 
This command will return a one of the light exists, otherwise a zero is returned. 


SYNTAX: 
Return Value=LIGHT EXIST(Light Number) 


LIGHT TYPE() 
This command will return one for point, two for spot and three for a directional light type. The default light 
type is directional light. 


SYNTAX: 
Return Value=LIGHT TYPE(Light Number) 


LIGHT POSITION X() 
This command will return the X position of the specified light. 


SYNTAX: 
Return Value=LIGHT POSITION X(Light Number) 


LIGHT POSITION Y() 
This command will return the Y position of the specified light . 


SYNTAX: 
Return Value=LIGHT POSITION Y(Light Number) 


LIGHT POSITION Z( ) 
This command will return the Z position of the specified light . 


SYNTAX: 
Return Value=LIGHT POSITION Z(Light Number) 


LIGHT DIRECTION X() 
This command will return the X value of the light direction. This is part of a normalized vector returned by 
the commands LIGHT DIRECTION X, Y and Z. 


SYNTAX: 
Return Value=LIGHT DIRECTION X(Light Number) 


LIGHT DIRECTION Y() 
This command will return the Y value of the light direction. This is part of a normalized vector returned by 
the commands LIGHT DIRECTION X, Y and Z. 


SYNTAX: 
Return Value=LIGHT DIRECTION Y (Light Number) 


LIGHT DIRECTION Z() 
This command will return the Z value of the light direction. This is part of a normalized vector returned by 
the commands LIGHT DIRECTION X, Y and Z. 


SYNTAX: 
Return Value=LIGHT DIRECTION Z(Light Number) 


LIGHT VISIBLE() 
This command will return a one if the light is active, otherwise zero is returned. 
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SYNTAX: 
Return Value=LIGHT VISIBLE (Light Number) 


LIGHT RANGE() 
This command will return the current range of the specified light. 


SYNTAX: 
Return Value=LIGHT RANGE (Light Number) 
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Matrix 3D Command Set 


You are able to store over sixty thousand matrix planes at any one time. A matrix plane is best described as 
a landscape that has been cut into a grid pattern. You can modify the landscape by raising and lowering a 
point on the grid, terra forming it to whatever you want. Additionally, you can apply a special texture that 
can contain several different styles of floor. These floor textures can then be mapped onto a point on the 
grid allowing you paint your landscape anyway you want. To make the matrix even more powerful, you can 
shift the matrix in any direction and it will automatically wrap around to effectively create an infinite 
landscape! 


MAKE MATRIX 

This command will create a matrix to a given width and depth segmented into grid square of a specified 
arrangement. A matrix can be thought of as a grid landscape with individual tiles that can be textured raised 
and lowered to create a wide variety of surfaces. The matrix number and segment values should be integer 
values. The width and depth should be real numbers. 


SYNTAX: 
MAKE MATRIX Matrix Number, Width, Depth, Xsegmented, Zsegmented 


SET MATRIX 

This command will change the visual properties of the matrix. When the wireframe flag is set to 0, the 
matrix only shows it's wireframe form. When the transparency flag is set to 0, all parts of the matrix colored 
black are not drawn to the screen. When the cull flag is set to 0, the matrix will draw polygons normally 
hidden due to the direction the polygon faces. The Filter Flag activates and deactivates texture filtering, 
which controls the smoothing effect of the texture as it is mapped to the matrix. The Light Flag activates 
and deactivates the matrices sensitivity to any lights in the scene. The Fog Flag activates and deactivates 
the matrices sensitivity to fog in the scene. The Ambient Flag activates and deactivates the matrices 
sensitivity to ambient light in the scene. The matrix number and flag values should be specified using 
integer values. 


SYNTAX 


SET MATRIX Matrix Number, Wireframe, Transparency, Cull, Filter, Light, Fog, Ambient 


POSITION MATRIX 
This command will place the specified matrix at a position in 3D space. The matrix number should be an 
integer value. The coordinates should be real numbers. 


SYNTAX: 
POSITION MATRIX Matrix Number, X, Y, Z 


PREPARE MATRIX TEXTURE 

This command will select an image of tiled textures that the matrix will eventually use. Each grid square in 
the matrix can have a tile texture, located within the image. Individual tile textures can be obtained from 
the single image by slicing it into sections both across and down. The tile textures are then assigned a 
number starting in the top left corner of the sectioned image and working across, then down. To section an 
image into 4 smaller tile textures you would specify 2 across and 2 down. 


Textures need to be of a particular size. The maximum image size you can use as a texture is 256x256. All 
images are ideally square and are divisible by 2. So texture sizes of 2x2, 4x4, 8x8, 16x16, 32x32, 64x64 and 
128x128 are the standard dimensions to use. The parameters should be integer values. 


SYNTAX: 
PREPARE MATRIX TEXTURE Matrix Number, Image Value, Across, Down 


FILL MATRIX 
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This command will set each grid square in the matrix to a specified height and tile number. The matrix 
number should be an integer value. The height should be a real number. The tile number must be valid 
texture tile allocated by the PREPARE MATRIX TEXTURE command and should be an integer value. 


SYNTAX: 
FILL MATRIX Matrix Number, Height, Tile Number 


RANDOMIZE MATRIX 
This command will set each grid square in the matrix to a random height between 0 and the height value 
given. The matrix number should be an integer value. The height should be a real number. 


SYNTAX: 
RANDOMIZE MATRIX Matrix Number, Height Range 


SET MATRIX HEIGHT 

This command will set the individual height of a point within the matrix. To raise a whole grid square you 
would need to raise four points, one from each corner of the square. If you set points x=0 z=0, x=0 z=1, 
x=1 z=0 and x=1 z=1 to a value of 10, you would raise the near left square upwards by ten units. The 
matrix number and tile reference values should be integer values. The height value should be a real 
number. 


SYNTAX: 
SET MATRIX HEIGHT Matrix Number, X, Z, Height 


SET MATRIX NORMAL 

This command will set the individual normal of a point within the matrix. The normal is a projected direction 
away from the vertex position that instructs the matrix how to take light for that point. You can use matrix 
normals to affect how the matrix is lit and at what strength. The matrix number and tile reference values 
should be integer values. The normal values should be real numbers. 


SYNTAX 


SET MATRIX NORMAL Matrix Number, X, Z, NormalX, NormalY, NormalZ 


SET MATRIX TILE 

This command will texture an individual grid square with an image specified by the tile number. Only if the 
matrix has been prepared with a texture will this command work. The tile number equates to a portion of 
graphic within the sectioned image you used to prepare the matrix texture. If you had prepared a matrix 
texture with four segmented images, you would reference these images as tile numbers from 1 to 4. The 
parameters should be integer values. 


SYNTAX: 
SET MATRIX TILE Matrix Number, X, Z, Tile Number 


SET MATRIX TEXTURE 

This command will set different texture modes used by the specified matrix. Every texture is painted onto a 
matrix using an internal set of values called UV data. This data contains a range of real numbers from zero 
to one. Zero specifying the top/left corner of your texture and one being the bottom/right corner of your 
texture. When a matrix uses UV data greater and less than this range, you are permitted a number of 
texture wrap modes to describe what should happen to paint these areas. Setting the Texture Wrap Mode 
to zero will use the default wrap mode which repeat the pattern of the texture over and over, a mode of 
one will mirror the texture to create a seamless texture pattern and a mode of two will set clamping which 
retains the colour of the last pixel at the textures edge and paint with that throughout the out of range 
area. The Mipmap Generation Flag is used to generate mipmap textures where mipmap textures do not 
exist. A mipmap is a texture that has many levels of detail, which the matrix can select and use based on 
the matrix tiles distance from the camera. Setting this flag to one will generate a mipmap for the specified 
object. Use integer values to specify the parameters. 
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SYNTAX: 
SET MATRIX TEXTURE Matrix Number, Texture Wrap Mode, Mipmap Generation Flag 


UPDATE MATRIX 

This command will update all changes you have made to an existing matrix. Any changes you have made 
are not visible until you complete the process by using the update matrix command. Updating the matrix is 
speed intensive and should be used as little as possible. The matrix number should be an integer value. 


SYNTAX: 
UPDATE MATRIX Matrix Number 


SHIFT MATRIX UP 

This command will shift the entire contents of the matrix one grid square up. The shift ensures that the 
height and tile data that represent the matrix contents are wrapped around to allow continuous shifting of 
the landscape. The matrix number should be an integer value. 


SYNTAX: 
SHIFT MATRIX UP Matrix Number 


SHIFT MATRIX DOWN 

This command will shift the entire contents of the matrix one grid square down. The shift ensures that the 
height and tile data that represent the matrix contents are wrapped around to allow continuous shifting of 
the landscape. The matrix number should be an integer value. 


SYNTAX: 
SHIFT MATRIX DOWN Matrix Number 


SHIFT MATRIX LEFT 

This command will shift the entire contents of the matrix one grid square to the left. The shift ensures that 
the height and tile data that represent the matrix contents are wrapped around to allow continuous shifting 
of the landscape. The matrix number should be an integer value. 


SYNTAX: 
SHIFT MATRIX LEFT Matrix Number 


SHIFT MATRIX RIGHT 

This command will shift the entire contents of the matrix one grid square to the right. The shift ensures that 
the height and tile data that represent the matrix contents are wrapped around to allow continuous shifting 
of the landscape. The matrix number should be an integer value. 


SYNTAX: 
SHIFT MATRIX RIGHT Matrix Number 


SET MATRIX WIREFRAME OFF 
This command will set the specified matrix to display itself in textured form. The matrix number should be 
an integer value. 


SYNTAX: 
SET MATRIX WIREFRAME OFF Matrix Number 


SET MATRIX WIREFRAME ON 
This command will set the specified matrix to display itself in wireframe form. The matrix number should be 
an integer value. 


SYNTAX: 
SET MATRIX WIREFRAME ON Matrix Number 
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GHOST MATRIX ON 
This command will make the matrix semi-transparent, allowing the user to see through it. The matrix 
number should be specified using an integer value. 


SYNTAX: 
GHOST MATRIX ON Matrix Number 


GHOST MATRIX OFF 
This command will make the matrix solid, as opposed to semi-transparent. The matrix number should be 
specified using an integer value. 


SYNTAX: 
GHOST MATRIX OFF Matrix Number 


DELETE MATRIX 
This command will delete a specified matrix previously created with make matrix. The matrix number should 
be an integer value. 


SYNTAX: 
DELETE MATRIX Matrix Number 


MATRIX EXPRESSIONS 


MATRIX EXIST() 
This command will return a one if the specified matrix exists otherwise zero will be returned. The matrix 
number should be an integer value. 


SYNTAX: 
Return Value=MATRIX EXIST (Matrix Number) 


MATRIX POSITION X() 
This command will return the X position of the specified matrix in 3D space. The matrix number should be 
an integer value. 


SYNTAX: 
Return Value=MATRIX POSITION X (Matrix Number) 


MATRIX POSITION Y() 
This command will return the y position of the specified matrix in 3D space. The matrix number should be 
an integer value. 


SYNTAX: 
Return Value=MATRIX POSITION Y (Matrix Number) 


MATRIX POSITION Z() 
This command will return the Z position of the specified matrix in 3D space. The matrix number should be 
an integer value. 


SYNTAX: 
Return Value=MATRIX POSITION Z(Matrix Number) 


GET MATRIX HEIGHT() 

This command will return the matrix height at the specified grid point coordinate. Do not confuse the grid 
reference X and Z values with coordinate values. The grid reference values are measured per tile, not per 
3D space unit. The matrix number and grid reference values should be integer values. 
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SYNTAX: 
Return Value=GET MATRIX HEIGHT (Matrix Number, X, Z) 


GET GROUND HEIGHT() 

This command will calculate and return the Y coordinate within the matrix given the X and Z coordinates. 
This command can be used to allows 3D objects to traverse the contours of any matrix landscape with ease. 
The matrix number should be an integer value. The coordinates should be real numbers. 


SYNTAX: 
Return Value=GET GROUND HEIGHT (Matrix Number, X, 2Z) 


MATRIX TILE COUNT() 
This command will return the number of available tile textures prepared for the specified matrix. The matrix 
number should be an integer value. 


SYNTAX: 
Return Value=MATRIX TILE COUNT (Matrix Number) 


MATRIX TILES EXIST() 
This command will return a one if the matrix has been prepared with textures, otherwise zero will be 
returned. The matrix number should be an integer value. 


SYNTAX: 
Return Value=MATRIX TILES EXIST (Matrix Number) 


MATRIX WIREFRAME STATE() 
This command will return a one if the specified matrix is displayed as a wireframe otherwise zero will be 
returned. The matrix number should be an integer value. 


SYNTAX: 
Return Value=MATRIX WIREFRAME STATE (Matrix Number) 
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System Command Set 


Your PC, and indeed any PC system that runs your software will have a wide range of capabilities that your 
program may wish to detect and utilize. You may also wish to present the user with a selection of possible 
modes and allow a selection to be made. 


GRAPHIC CARDS 


PERFORM CHECKLIST FOR GRAPHICS CARDS 
This command will make a checklist of all installed display cards. Some system have more than one 3D 
accelerator installed and often provide different feature sets and levels of performance. 


SYNTAX: 
PERFORM CHECKLIST FOR GRAPHICS CARDS 


SET GRAPHICS CARD 
This command will set the current display card as described by the name provided. The display card name 
can be found by performing a PERFORM CHECKLIST FOR GRAPHICS CARDS. 


SYNTAX: 
SET GRAPHICS CARD Name$ 


SET EMULATION ON 

This command will set the system to software emulation. 3D accelerator hardware is not used in this mode 
and renders all 3D using the system processor. This method of rendering 3D is very slow and cannot be 
used for mainstream 3D games. 


SYNTAX: 
SET EMULATION ON 


SET EMULATION OFF 
This command will set the system to hardware acceleration. Any 3D accelerator hardware will be taken 
advantage of when rendering 3d objects to the screen. 


SYNTAX: 
SET EMULATION OFF 


EMPTY CHECKLIST 
This command will clear the general purpose checklist facility. 


SYNTAX: 
EMPTY CHECKLIST 


DISABLE TNL 
This command will deactivate the use of hardware transformation and lighting. Hardware T&L is a form of 
acceleration that some cards are capable of. T&L frees the main processor from the workload of processing 
your 3D scenes. 


SYNTAX: 
DISABLE TNL 


ENABLE TNL 
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This command will activate the use of hardware transformation and lighting. Hardware T&L is a form of 
acceleration that some cards are capable of. T&L frees the main processor from the workload of processing 
your 3D scenes. 


SYNTAX: 
ENABLE TNL 


TNL AVAILABLE() 

This command will return a value of one if the system is currently using transformation and lighting in 
hardware. Only graphics cards that have a T&L chipset will be able to render using HW transformation and 
lighting. T&L is active by default if the system supports it. 


SYNTAX: 
Return Value=TNL AVAILABLE () 


CHECKLIST QUANTITY() 
This command will return the total number of items in the checklist after a PERFORM CHECKLIST command 
has been performed. 


SYNTAX: 
Return Value=CHECKLIST QUANTITY () 


CHECKLIST VALUE A() 
This command will return value A from the specified item number in the checklist after a PERFORM 
CHECKLIST command has been performed. The item number should be an integer value. 


SYNTAX: 
Return Value=CHECKLIST VALUE A(Item Number) 


CHECKLIST VALUE B() 
This command will return value B from the specified item number in the checklist after a PERFORM 
CHECKLIST command has been performed. The item number should be an integer value. 


SYNTAX: 
Return Value=CHECKLIST VALUE B(Item Number) 


CHECKLIST VALUE C() 
This command will return value C from the specified item number in the checklist after a PERFORM 
CHECKLIST command has been performed. The item number should be an integer value. 


SYNTAX: 
Return Value=CHECKLIST VALUE C(Item Number) 


CHECKLIST VALUE D() 
This command will return value D from the specified item number in the checklist after a PERFORM 
CHECKLIST command has been performed. The item number should be an integer value. 


SYNTAX: 
Return Value=CHECKLIST VALUE D(Item Number) 


CHECKLIST STRING$() 
This command will return the string from the specified item number in the checklist after a PERFORM 
CHECKLIST command has been performed. The item number should be an integer value. 


SYNTAX: 
Return String=CHECKLIST STRINGS (Item Number) 
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SCREEN INVALID() 
This command will return a one if the application has been switched out and back in. A typical switch out is 
when the user uses the keys ALT+TAB. 


SYNTAX: 
Return Value=SCREEN INVALID () 


CURRENT GRAPHICS CARD$() 
This command will return the name of the current display card being used by the system. 


SYNTAX: 
Return String=CURRENT GRAPHICS CARDS () 


EMULATION MODE() 
This command will return an integer value of one if the system is in software emulation mode, otherwise 
zero will be returned. 


SYNTAX: 
Return Value=EMULATION MODE () 


DARK BASIC SYSTEM COMMANDS 


DISABLE ESCAPEKEY 
This command will deactivate the escape key. Be aware that this command will prevent breaking back into 
your program without a suitable exit condition. 


SYNTAX: 
DISABLE ESCAPEKEY 


ENABLE ESCAPEKEY 
This command will reactivate the escape key. The escape key is deactivated using the DISABLE ESCAPEKEY. 


SYNTAX: 
ENABLE ESCAPEKEY 


EXIT PROMPT 
This command will trigger a messagebox to pop up on termination of your application. This command can 
be useful if you are debugging and require data to be viewed quickly on exiting your full screen application. 


SYNTAX: 
EXIT PROMPT Title Name, Description Name 


WINDOW CONTROL COMMANDS 


HIDE WINDOW 

This command will hide the window but keep the application active. It is important you restore your 
application using SHOW WINDOW before terminating or passing control to the user as this command 
completely hides the application. 


SYNTAX: 
HIDE WINDOW 


SHOW WINDOW 
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This command will show the window, having previously been hidden by the HIDE WINDOW command. 


SYNTAX: 
SHOW WINDOW 


MINIMIZE WINDOW 
This command will minimise the window. 


SYNTAX: 
MINIMIZE WINDOW 


MAXIMIZE WINDOW 
This command will maximise the window to the entire desktop screen. 


SYNTAX: 
MAXIMIZE WINDOW 


RESTORE WINDOW 
This command will restore the window top the original size and position. 


SYNTAX: 
RESTORE WINDOW 


ALWAYS ACTIVE ON 
Switches applications to ‘always active’ mode, where the program will constantly run even if the application 
does not have focus. An application looses focus when you use ALT+TAB to activate another application. 


SYNTAX: 
ALWAYS ACTIVE ON 


ALWAYS ACTIVE OFF 
Switches applications to normal mode, where the program pauses all activity while it does not have focus. 
An application looses focus when you use ALT+TAB to activate another application. 


SYNTAX: 
ALWAYS ACTIVE OFF 


SET WINDOW TITLE 
This command will change the title of the window. You can specify a title string up to 255 characters. 


SYNTAX: 
SET WINDOW TITLE String 


SET WINDOW ON 
This command will activate Windows Mode, forcing your application to run in a window with its own title bar 
and border. 


SYNTAX: 
SET WINDOW ON 


SET WINDOW OFF 
This command will deactivate Windows mode. 


SYNTAX: 
SET WINDOW OFF 


SET WINDOW LAYOUT 
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This command will set the window settings. If the Full Window Flag is set to one the window is created with 
title bar, minimise and close icons and an icon. If the Title Bar Flag is set to zero, the title bar is removed 
from the window. If the Icon Flag is zero, the icon is removed from the window. 


SYNTAX: 
SET WINDOW LAYOUT Full Window Flag, Title Bar Flag, Icon Flag 


SET WINDOW POSITION 
This command will set the windows position. 


SYNTAX: 
SET WINDOW POSITION X, Y 


SET WINDOW SIZE 
This command will set the windows size. You must specify the Width and Height parameters using integer 
values. 


SYNTAX: 
SET WINDOW SIZE Width, Height 


DISABLE SYSTEMKEYS 
This command will disable the use of such system keys as ALT+TAB, ALT+F4. 


SYNTAX: 
DISABLE SYSTEMKEYS 


ENABLE SYSTEMKEYS 
This command will enable all system keys disabled with DISABLE SYSTEMKEYS. 


SYNTAX: 
ENABLE SYSTEMKEYS 


APPNAMES() 

This command will return the full path and filename of the executable built from the program. You can use 
this command to determine the name of the executable you are running under, and thus can only return a 
string when you have compiled this program and run as an executable. 


SYNTAX: 
Return String = APPNAMES () 


WINDIRS() 

This command will return the path string of windows directory. You can use this command to determine the 
current Windows directory and thus find and use such areas as the Windows temporary folder (typically 
“c:\Windows\temp”). It is always good practise to use this command to locate the correct location of the 
Windows directory. 


SYNTAX: 
Return String = WINDIRS() 


DLL COMMANDS (Enhancement Pack Only) 


LOAD DLL (Enhancement Pack Only) 

This command will load a DLL into memory under the specified DLL Number. The DLL file must exist either 
in the current working directory or the Windows system folder. If the file is not found this command will fail. 
The DLL Number must be an integer value between 1 and 256. 


SYNTAX: 
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LOAD DLL FilenameS, DLL Number 


DELETE DLL (Enhancement Pack Only) 
This command will delete a previously loaded DLL. If the DLL does not exist this command will fail. The DLL 
Number must be an integer value between 1 and 256. 


SYNTAX: 
DELETE DLL DLL Number 


CALL DLL (Enhancement Pack Only) 

This command will call a function of a loaded DLL. The DLL Number must be an integer value between 1 
and 256. The DLL Number points to the DLL previously loaded. The Function String is the name of the 
function described in the export table of the DLL. You can optionally have upto 9 parameters of integer, real 
or string type providing the function you are calling matches the parameters exactly. You can optionally 
return a value of integer, real or string type providing the function exports the same type. 


SYNTAX: 
CALL DLL DLL Number, Function String, [Params] 
Return Data = CALL DLL(DLL Number, Function String, [Params] ) 


DLL EXIST (Enhancement Pack Only) 
This command determines whether a DLL has been loaded successfully. The DLL Number must be an 
integer value between 1 and 256. If the DLL exists an integer value of one is returned, otherwise zero. 


SYNTAX: 
Return Value = DLL EXIST(DLL Number) 


DLL CALL EXIST (Enhancement Pack Only) 

This command determines whether a function call exists within a loaded DLL. The DLL Number must be an 
integer value between 1 and 256. The DLL Number specifies a previously loaded DLL and the Function 
String describes the function name within the DLL. If the function exists an integer value of one is returned, 
otherwise zero. 


SYNTAX: 
Return Value = DLL CALL EXIST(DLL Number, Function String) 


MEMORY COMMANDS 


SYSTEM DMEM AVAILABLE() 
This command will return the total video memory available on the system. 


SYNTAX: 
Return Value=SYSTEM DMEM AVAILABLE () 


SYSTEM SMEM AVAILABLE() 
This command will return the total system memory available on the system. 


SYNTAX: 
Return Value=SYSTEM SMEM AVAILABLE () 


SYSTEM TMEM AVAILABLE() 
This command will return the total memory available on your system. 


SYNTAX: 
Return Value=SYSTEM TMEM AVAILABLE () 
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Memory Blocks 


(Enhancement Pack Only) 


Memblocks are used to store and manipulate various types of data. Unlike arrays that can store basic 
values, memory blocks can be used to manipulate bitmap, image, sound and even 3D mesh data. There are 
256 memblocks available and share the common ability to manipulate data at the byte level, share their 
internal memory pointers and copy between memblocks easily. 


MANAGING MEMORY BLOCKS 


MAKE MEMBLOCK (Enhancement Pack Only) 
This command will make a memblock of the given size. If the memblock already exists this command will 
fail. The parameters must be specified using integer values. 


SYNTAX: 
MAKE MEMBLOCK Memblock Number, Size in Bytes 


DELETE MEMBLOCK (Enhancement Pack Only) 
This command will delete a memblock. If the memblock does not exist this command will fail. The 
parameter must be specified using a integer value. 


SYNTAX: 
DELETE MEMBLOCK Memblock Number 


COPY MEMBLOCK (Enhancement Pack Only) 

This command will copy one section of a memblock to another section of another memblock. The From and 
To parameters must be existing memblocks. The PosFrom and PosTo parameters must be byte locations 
within the respective memblocks. The Bytes parameter is the number of bytes you wish to copy from one 
memblock to the other. 


SYNTAX: 
COPY MEMBLOCK From, To, PosFrom, PosTo, Bytes 


WRITING INTO MEMORY BLOCKS 


WRITE MEMBLOCK BYTE (Enhancement Pack Only) 

This command will write a byte into the specified location of the memblock. The memblock must exist or the 
command will fail. The Position value is specified in bytes. The Byte value must be a value between 0 and 
255. The parameters must be specified using integer values. 


SYNTAX: 
WRITE MEMBLOCK BYTE Memblock Number, Position, Byte 


WRITE MEMBLOCK WORD _ = (Enhancement Pack Only) 

This command will write a word into the specified location of the memblock. A Word is the term for a 
datatype consisting of two bytes. The memblock must exist or the command will fail. The Position value is 
specified in bytes. The Word value must be a value between 0 and 65535. The parameters must be 
specified using integer values. 


SYNTAX: 
WRITE MEMBLOCK WORD Memblock Number, Position, Word 


WRITE MEMBLOCK DWORD (Enhancement Pack Only) 
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This command will write a dword into the specified location of the memblock. A DWord is the term for a 
datatype consisting of four bytes. The memblock must exist or the command will fail. The Position value is 
specified in bytes. The DWord value must be a value between 0 and 2147483648. The parameters must be 
specified using integer values. 


SYNTAX: 
WRITE MEMBLOCK DWORD Memblock Number, Position, DWord 


WRITE MEMBLOCK FLOAT (Enhancement Pack Only) 

This command will write a float into the specified location of the memblock. A Float is the term for a 
datatype consisting of four bytes, also referred to as a real number. The memblock must exist or the 
command will fail. The Position value is specified in bytes. The Float value must be a value between - 
2147483648 to 2147483648. The parameters must be specified using integer values. 


SYNTAX: 
WRITE MEMBLOCK FLOAT Memblock Number, Position, Float 


MEMBLOCK EXIST (Enhancement Pack Only) 
This command will return a value of one if the specified memblock exists, otherwise zero is returned. The 
parameter must be an integer value. 


SYNTAX: 
Return Value = MEMBLOCK EXIST (Memblock Number) 


GET MEMBLOCK PTR (Enhancement Pack Only) 
This command will return the actual pointer of the specified memblock. You can use this pointer to pass into 
a DLL in order to access the memory directly. The parameter must be an integer value. 


SYNTAX: 
Return Value = GET MEMBLOCK PTR(Memblock Number) 


GET MEMBLOCK SIZE (Enhancement Pack Only) 
This command will return the size of the specified memblock. The size will be returned in bytes. The 
parameter must be an integer value. 


SYNTAX: 
Return Value = GET MEMBLOCK SIZE (Memblock Number) 


MEMBLOCK BYTE (Enhancement Pack Only) 

This command will read a byte from the specified location of the memblock. The memblock must exist or 
the command will fail. The Position value is specified in bytes. The Byte returned will be a value between 0 
and 255. The parameters must be specified using integer values. 


SYNTAX: 
Return Value = MEMBLOCK BYTE (Memblock Number, Position) 


MEMBLOCK WORD (Enhancement Pack Only) 

This command will read a word from the specified location of the memblock. The memblock must exist or 
the command will fail. The Position value is specified in bytes. The Word returned will be a value between 0 
and 65535. The parameters must be specified using integer values. 


SYNTAX: 
Return Value = MEMBLOCK WORD (Memblock Number, Position) 


MEMBLOCK DWORD (Enhancement Pack Only) 

This command will read a dword from the specified location of the memblock. The memblock must exist or 
the command will fail. The Position value is specified in bytes. The DWord returned will be a value between 
0 and 2147483648. The parameters must be specified using integer values. 
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SYNTAX: 
Return Value = MEMBLOCK DWORD(Memblock Number, Position) 


MEMBLOCK FLOAT (Enhancement Pack Only) 

This command will read a float from the specified location of the memblock. The memblock must exist or 
the command will fail. The Position value is specified in bytes. The Float returned will be a value between - 
2147483648 to 2147483648. The parameters must be specified using integer values. 


SYNTAX: 
Return Value = MEMBLOCK FLOAT (Memblock Number, Position) 


USING MEMORY BLOCKS WITH MULTIMEDIA DATA 


MAKE MEMBLOCK FROM BITMAP (Enhancement Pack Only) 
This command will make a memblock from a bitmap. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described below. 


Memblock- Bitmap (12 Byte Header) 
Header 


4 BYTES (DWORD) Width 
4 BYTES (DWORD) Height 
4 BYTES (DWORD) Depth 


Data 
X BYTES - Pixel Data (a 16bit bitmap uses 2 BYTES per Pixel) 


SYNTAX: 
MAKE MEMBLOCK FROM BITMAP Memblock Number, Bitmap Number 


MAKE BITMAP FROM MEMBLOCK (Enhancement Pack Only) 

This command will make a bitmap from a memblock. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described above in 
MAKE MEMBLOCK FROM BITMAP. 


SYNTAX: 
MAKE BITMAP FROM MEMBLOCK Bitmap Number, Memblock Number 


MAKE MEMBLOCK FROM IMAGE (Enhancement Pack Only) 
This command will make a memblock from an image. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described below. 


Memblock- Image (12 Byte Header) 
Header 


4 BYTES (DWORD) Width 
4 BYTES (DWORD) Height 
4 BYTES (DWORD) Depth 


Data 
X BYTES - Pixel Data (a 16bit bitmap uses 2 BYTES per Pixel) 


SYNTAX: 
MAKE MEMBLOCK FROM IMAGE Memblock Number, Image Number 


MAKE IMAGE FROM MEMBLOCK (Enhancement Pack Only) 

This command will make an image from a memblock. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described above in 
MAKE MEMBLOCK FROM IMAGE. 


MAKE IMAGE FROM MEMBLOCK Image Number, Memblock Number 
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MAKE MEMBLOCK FROM SOUND (Enhancement Pack Only) 
This command will make a memblock from a sound. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described below. 


Memblock-Sound_ (12 Byte Header) 
Header 
4 BYTES (DWORD) Bits per Sample 
4 BYTES (DWORD) Frequency 
4 BYTES (DWORD) Number of Samples 
Data 
X BYTES - Sample Data (16bit sound data uses a 2 BYTE sample) 


SYNTAX: 
MAKE MEMBLOCK FROM SOUND Memblock Number, Sound Number 


MAKE SOUND FROM MEMBLOCK (Enhancement Pack Only) 

This command will make a sound from a memblock. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described above in 
MAKE MEMBLOCK FROM SOUND. 


SYNTAX: 
MAKE SOUND FROM MEMBLOCK Sound Number, Memblock Number 


MAKE MEMBLOCK FROM MESH (Enhancement Pack Only) 
This command will make a memblock from a mesh. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described below. 


Memblock-Mesh (32 Byte Header) 
Header 
4 BYTES (DWORD) Number Of Vertices 
4 BYTES (DWORD) Offset in Bytes to Vertice Data 
4 BYTES (DWORD) Number Of Normals 
4 BYTES (DWORD) Offset in Bytes to Normals Data 
4 BYTES (DWORD) Number of Faces 
4 BYTES (DWORD) Offset in Bytes to Face Data 
4 BYTES (DWORD) Size Of All Face Data 
4 BYTES (DWORD) Offset in Bytes to Texture UV Data 
Data 
Vertice Data 


For Each Vertex 

4 BYTES (FLOAT) - X Position of 3D Geometry 

4 BYTES (FLOAT) - Y Position of 3D Geometry 

4 BYTES (FLOAT) - Z Position of 3D Geometry 
Normals Data 


For Each Normal 
4 BYTES (FLOAT) - X Normalised Normal of 3D Geometry 
4 BYTES (FLOAT) - Y Normalised Normal of 3D Geometry 
4 BYTES (FLOAT) - Z Normalised Normal of 3D Geometry 
Face Data 

For Each Face (a face makes a polygon using A,B and C as vector points) 
2 BYTES (DWORD) - Number of Vectors in Face (always use 3) 
2 BYTES (DWORD) - Index to Vertex in Vertex Data for Vector A 
2 BYTES (DWORD) - Index to Normal in Vertex Data for Vector A 
2 BYTES (DWORD) - Index to Vertex in Vertex Data for Vector B 
2 BYTES (DWORD) - Index to Normal in Vertex Data for Vector B 
2 BYTES (DWORD) - Index to Vertex in Vertex Data for Vector C 
2 BYTES (DWORD) - Index to Normal in Vertex Data for Vector C 

Texture Data 


For Each Vertex 
4 BYTES (FLOAT) - U Value of Texture 
4 BYTES (FLOAT) - V Value of Texture 
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SYNTAX: 
MAKE MEMBLOCK FROM MESH Memblock Number, Mesh Number 


MAKE MESH FROM MEMBLOCK (Enhancement Pack Only) 

This command will make a mesh from a memblock. The specified values must be integer values and the 
source resource must exist or the command will fail. The memblock stores the data as described above in 
MAKE MEMBLOCK FROM MESH. 


SYNTAX: 
MAKE MESH FROM MEMBLOCK Mesh Number, Memblock Number 


CHANGE MESH FROM MEMBLOCK (Enhancement Pack Only) 

This command will change a mesh from a memblock. This command is similar to MAKE MESH FROM 
MEMBLOCK, and skips the mesh creation step to make this command faster. You must ensure the mesh 
uses the same data structure as the memblock or this command will produce undesirable results. The 
specified values must be integer values and the source resource must exist or the command will fail. The 
memblock stores the data as described above in MAKE MEMBLOCK FROM MESH. 


SYNTAX: 
CHANGE MESH FROM MEMBLOCK Mesh Number, Memblock Number 


BACK BUFFER COMMANDS 


LOCK BACKBUFFER (Enhancement Pack Only) 

This command locks the backbuffer and stores the backbuffer details for direct access. The backbuffer is the 
actual screen you see each refresh and this command allows you to pass the pointer and other essential 
data to a DLL for screen modification. Locking the backbuffer prevents other activities to be performed 
regarding the backbuffer so it is essential you unlock the backbuffer when you have finished. 


SYNTAX: 
LOCK BACKBUFFER 


UNLOCK BACKBUFFER (Enhancement Pack Only) 

This command unlocks the backbuffer and frees the system to continue as normal. The backbuffer is the 
actual screen you see each refresh. Locking the backbuffer prevents other activities to be performed 
regarding the backbuffer so it is essential you unlock the backbuffer when you have finished. 


SYNTAX: 
UNLOCK BACKBUFFER 


GET BACKBUFFER PTR (Enhancement Pack Only) 

This command will return the actual pointer to the backbuffer. You can pass the pointer to a DLL which can 
directly access the memory of the backbuffer. You can only use this command when you have used the 
LOCK BACKBUFFER command. 


SYNTAX: 
Return Pointer = GET BACKBUFFER PTR() 


GET BACKBUFFER WIDTH (Enhancement Pack Only) 

This command will return the width of the backbuffer. You can pass this data to a DLL to assist in the direct 
access of backbuffer memory. You can only use this command when you have used the LOCK BACKBUFFER 
command. 


SYNTAX: 
Return Value = GET BACKBUFFER WIDTH () 
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GET BACKBUFFER HEIGHT (Enhancement Pack Only) 

This command will return the height of the backbuffer. You can pass this data to a DLL to assist in the direct 
access of backbuffer memory. You can only use this command when you have used the LOCK BACKBUFFER 
command. 


SYNTAX: 
Return Value = GET BACKBUFFER HEIGHT () 


GET BACKBUFFER DEPTH (Enhancement Pack Only) 

This command will return the depth of the backbuffer. You can pass this data to a DLL to assist in the direct 
access of backbuffer memory. You can only use this command when you have used the LOCK BACKBUFFER 
command. 


SYNTAX: 
Return Value = GET BACKBUFFER DEPTH () 


GET BACKBUFFER PITCH (Enhancement Pack Only) 

This command will return the pitch of the backbuffer. You can pass this data to a DLL to assist in the direct 
access of backbuffer memory. The pitch is similar to the width of the backbuffer, and may be larger should 
the backbuffer use a cache at the end of each horizontal line. You can only use this command when you 
have used the LOCK BACKBUFFER command. 


SYNTAX: 
Return Value = GET BACKBUFFER PITCH() 
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Multiplayer 


Multiplayer is used to create and control games whose players reside on different machines. This is achieved 
through a standardised connection system which allows the same commands to be used no matter whether 
the game was created across a serial connection, modem, local area network or Internet. The net game 
commands are extremely simple to use, and you can create a game and send data in just two commands! 
There can only be one net game per application, however with multiple applications running you can 
simulate a network game on a single machine. 


MULTIPLAYER SETUP AND HOSTING COMMANDS 


PERFORM CHECKLIST FOR NET CONNECTIONS 

This command will fill the checklist with the names of all the currently available connections on the machine. 
There are usually four types of connections available to you including TCP/IP, IPX, Modem and Serial. 
TCP/IP is used to connect via an IP Address and is used for Internet games. IPX is used for playing net 
games over a Local Area Network (LAN). A Modem connection is a two player net game with a Dial player 
and a Receive player, played over a phone line. A Serial connection is a direct cable connecting two 
machines, and acts much like a Modem connection. The index of the checklist is also the connection number 
associated with the connection description obtained from this command. 


SYNTAX: 
PERFORM CHECKLIST FOR NET CONNECTIONS 


SET NET CONNECTION 

This command will set the machine to a specific connection. The Connection Number can be obtained by 
using the index of the checklist produced by the PERFORM CHECKLIST FOR NET CONNECTIONS command. 
You can optionally specify Address Data depending on the connection type. If you connect by TCP/IP the 
Address Data should be an IP and URL Address. If the connection type is MODEM, you should specify a 
phone number if you are dialling or leave blank if you are answering. If the connection type is SERIAL, it is 
recommended you leave the Address Data blank to obtain the Windows Serial Configuration Dialogue Box. 
IPX connections require no additional Address Data. 


SYNTAX: 
SET NET CONNECTION Connection Number 
SET NET CONNECTION Connection Number, Address Data 


PERFORM CHECKLIST FOR NET SESSIONS 

This command will fill the checklist with the names of all the currently available sessions on the previously 
specified connection. The session names represent a currently running net game. These are net games you 
are able to join. The index of the checklist is also the session number associated with the session description 
obtained from this command. 


SYNTAX: 
PERFORM CHECKLIST FOR NET SESSIONS 


CREATE NET GAME 

This command will create a multiplayer net game. The Gamename describes the name of the game and will 
be the name of the session when the game begins. The Playername is the name you wish to give the initial 
host of the game. The number of players can be between 2 and 256, and sets the maximum number of 
players that can join the net game. You can optionally specify a flag which controls the type of net game 
created. A value of 1 is the default and specifies a Pier to Pier game, where a value of 2 specifies a 
Client/Server game. A Pier to Pier game has every computer communicate with each other. A Client/Server 
game has all player traffic routed through the host computer and then broadcasted to the rest of the 
players. 
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You will need to set a connection before you can create a net game, however this command will 
automatically select the first connection it finds if you have selected one. 


SYNTAX: 
CREATE NET GAME Gamename, Playername, Number Of Players<br> 
CREATE NET GAME Gamename, Playername, Number Of Players, Flag 


JOIN NET GAME 

This command will join a currently running net game session. To join a net game, you must first find one 
using PERFORM CHECKLIST FOR NET SESSIONS. From this you can find the Session Number required to 
join the net game. The Playername is the name the player uses when entering the net game session. If the 
specified session does not exist, or there are too many players in the session, this command will fail. 


SYNTAX: 
JOIN NET GAME Session Number, Playername 


FREE NET GAME 

This command will terminate a net game currently in session. You can only have one net game running at 
any one time per application, so in order to create a new game you must first free up any existing net 
games currently running. If you joined an existing net gane, this command will remove you from the game 
and the game will continue running without you. 


SYNTAX: 
FREE NET GAME 


NET GAME EXISTS() 
This command will return a value of one if the net game exists, otherwise zero is returned. 


SYNTAX: 
Return Value = NET GAME EXISTS () 


NET GAME NOW HOSTING() 

This command will return a value of one if the application has just been made the host of the net game, 
otherwise zero is returned. During a Pier to Pier net game, if the host leaves the net game then host status 
is migrated to another player in the net game. 


SYNTAX: 
Return Value = NET GAME NOW HOSTING () 


NET GAME LOST() 
This command will return a value of one if the net game has been lost, otherwise zero is returned. 


SYNTAX: 
Return Value = NET GAME LOST() 


PLAYER MANAGEMENT COMMANDS 


PERFORM CHECKLIST FOR NET PLAYERS 

This command will fill the checklist with all the players currently seen by the currently active net game. The 
checklist contains five pieces of data for each player listed. The checklist string contains the given name of 
the player. The checklist value A contains a Unique ID provided for the player when the player appeared in 
the net gane. This ID is only unique to the application and will remain with the player as long as it resides in 
the net game. You can use this ID to reference an array containing the players game data. The checklist 
value B contains a special universal ID for the player, and this value does not change from machine to 
machine. You can use it to isolate a player on any machine. Checklist Value C will be set to one if the listed 


141 


player is the current local player. Checklist Value D will be set to one if the listed player is the host player of 
the net game. 


SYNTAX: 
PERFORM CHECKLIST FOR NET PLAYERS 


CREATE NET PLAYER 

This command will create another player within the net game. This player will be an additional player to the 
default player created when you created or joined the game. You can use this command if you wished to 
populate your net game with allies or enemies to be treated like regular players. The Playername is the 
given name of the player for the net game. You can optionally return the Player Number at the moment of 
creation. 


SYNTAX: 
CREATE NET PLAYER Playername 
Return Value = CREATE NET PLAYER (Playername) 


FREE NET PLAYER 

This command will remove a player from the current net game. The Player Number refers to the Unique ID 
that was given to the player when it was created. You can obtain this value from the checklist value a result 
produced when you use the PERFORM CHECKLIST FOR NET PLAYERS command. 


SYNTAX: 
FREE NET PLAYER Player Number 


NET MESSAGE PLAYER FROM() 
This command returns the Player Number that the current message was sent from. You can use this to 
determine who sent the message. 


SYNTAX: 
Return Value = NET MESSAGE PLAYER FROM() 


NET MESSAGE PLAYER TQ() 
This command returns the Player Number that the current message is being sent to. You can use this to 
determine who the message is for, and whether it is a message for you. 


SYNTAX: 
Return Value = NET MESSAGE PLAYER TO() 


NET PLAYER DESTROYED() 

This command will return the Player Number of a newly removed player from the net game. The Player 
Number is the Unique ID you have been using to reference this player. You do not need to free this player 
when you receive this signal as it has already been done for you. 


SYNTAX: 
Return Value = NET PLAYER DESTROYED () 


NET PLAYER CREATED() 

This command will return the Player Number of a newly created player to the net game. The Player Number 
is the Unique ID you can use to initialise a new player in your game data. You do not need to create a new 
player when you receive this signal as it has already been done for you. 


SYNTAX: 
Return Value = NET PLAYER CREATED () 


SENDING MULTIPLAYER DATA 


SEND NET MESSAGE INTEGER 
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This command will send a message containing an integer value to the specified player. The Player Number 
must be an integer value and an existing player in the net game. A Player Number of zero will send the 
message to all players except you. 


SYNTAX: 
SEND NET MESSAGE INTEGER Player Number, Integer Value 


SEND NET MESSAGE FLOAT 

This command will send a message containing a float value to the specified player. The Player Number must 
be an integer value and an existing player in the net game. A Player Number of zero will send the message 
to all players except you. 


SYNTAX: 
SEND NET MESSAGE FLOAT Player Number, Float Value 


SEND NET MESSAGE STRING 

This command will send a message containing a string to the specified player. The Player Number must be 
an integer value and an existing player in the net game. A Player Number of zero will send the message to 
all players except you. 


SYNTAX: 
SEND NET MESSAGE STRING Player Number, String 


SEND NET MESSAGE MEMBLOCK 

This command will send a message containing a memblock to the specified player. The Player Number must 
be an integer value and an existing player in the net game. The memblock must exist or the command will 
fail. A Player Number of zero will send the message to all players except you. The Guarantee Packet Flag, if 
set to one, will ensure the message is received and will not be dropped due to slow system performance. 


SYNTAX: 
SEND NET MESSAGE MEMBLOCK Player Number, Memblock Number 
SEND NET MESSAGE MEMBLOCK Player Number, Memblock Number, Guarantee Packet 


SEND NET MESSAGE IMAGE 

This command will send a message containing an image to the specified player. The Player Number must be 
an integer value and an existing player in the net game. A Player Number of zero will send the message to 
all players except you. The Guarantee Packet Flag, if set to one, will ensure the message is received and will 
not be dropped due to slow system performance. 


SYNTAX: 
SEND NET MESSAGE IMAGE Player Number, Image Number, Guarantee Packet 


SEND NET MESSAGE BITMAP (Enhancement Pack Only) 

This command will send a message containing a bitmap to the specified player. The Player Number must be 
an integer value and an existing player in the net game. A Player Number of zero will send the message to 
all players except you. The Guarantee Packet Flag, if set to one, will ensure the message is received and will 
not be dropped due to slow system performance. 


SYNTAX: 
SEND NET MESSAGE BITMAP Player Number, Bitmap Number, Guarantee Packet 


SEND NET MESSAGE SOUND (Enhancement Pack Only) 

This command will send a message containing a sound to the specified player. The Player Number must be 
an integer value and an existing player in the net game. A Player Number of zero will send the message to 
all players except you. The Guarantee Packet Flag, if set to one, will ensure the message is received and will 
not be dropped due to slow system performance. 


SYNTAX: 
SEND NET MESSAGE SOUND Player Number, Sound Number, Guarantee Packet 
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SEND NET MESSAGE MESH (Enhancement Pack Only) 

This command will send a message containing a mesh to the specified player. The Player Number must be 
an integer value and an existing player in the net game. A Player Number of zero will send the message to 
all players except you. The Guarantee Packet Flag, if set to one, will ensure the message is received and will 
not be dropped due to slow system performance. 


SYNTAX: 
SEND NET MESSAGE MESH Player Number, Mesh Number, Guarantee Packet 


RECEIVING MULTIPLAYER DATA 


GET NET MESSAGE 

This command gets the oldest message from the incoming message queue and makes it the current 
message. Any messages that are sent to this application are stored on a queue and you are able to take 
each message and process it. You can use the NET MESSAGE EXISTS() command to determine when there 
are no more messages in the queue. 


SYNTAX: 
GET NET MESSAGE 


The next commands will return a result: 


NET MESSAGE INTEGER 
This command will return an integer value from the current net message. The net message must be of the 
integer type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
Return Value = NET MESSAGE INTEGER () 


NET MESSAGE FLOAT 
This command will return a float value from the current net message. The net message must be of the float 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
Return Value = NET MESSAGE FLOAT () 


NET MESSAGE STRING 
This command will return a string from the current net message. The net message must be of the string 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
Return Value = NET MESSAGE STRINGS () 


NET MESSAGE MEMBLOCK 

This command will return a memblock from the current net message. The net message must be of the 
memblock type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 
If a memblock already exists under this number, that memblock is deleted and the new memblock is 
created in its place. 


SYNTAX: 
NET MESSAGE MEMBLOCK Memblock Number 


NET MESSAGE IMAGE 
This command will return an image from the current net message. The net message must be of the image 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
NET MESSAGE IMAGE Image Number 
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NET MESSAGE BITMAP 
This command will return a bitmap from the current net message. The net message must be of the bitmap 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
NET MESSAGE BITMAP Bitmap Number 


NET MESSAGE SOUND 
This command will return a sound from the current net message. The net message must be of the sound 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
NET MESSAGE SOUND Sound Number 


NET MESSAGE MESH 
This command will return a mesh from the current net message. The net message must be of the mesh 
type or the command will fail. You can determine type using the NET MESSAGE TYPE command. 


SYNTAX: 
NET MESSAGE MESH Mesh Number 


NET MESSAGE EXISTS() 
This command will return a value of one if the message queue contains one or more messages for the 
current application. A value zero means the queue is empty. 


SYNTAX: 
Return Value = NET MESSAGE EXISTS () 


NET MESSAGE TYPE() 

This command returns the type of the current message in the queue. The type can be one of four values. If 
the type is 1, the message is an integer value. If the type is 2, the message is a float value. If the type is 3, 
the message is a string. If the type is a 4, then the message is a memblock. You must check the type of a 
message before you can read it correctly using one of the appropriate NET MESSAGE commands. 


SYNTAX: 
Return Value = NET MESSAGE TYPE () 
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Hidden Commands 


When DarkBASIC was first released it included a few hidden commands. We now reveal them so you can 
exploit every byte of the engine. 


PRINTC 
This command will print out the contents of the string value to screen. Unlike the standard PRINT 
command, the cursor will remain at the end of the line allowing you to continue printing on the same line. 


SYNTAX: 
PRINTC String Value 


ROTATE IMAGE 
This command will rotate the specified image by ninety degree steps if supported in hardware. Value 
degrees are 0, 90, 180 and 270 and must be specified as integer values. 


SYNTAX: 
ROTATE IMAGE Image Number, Degree 


3DS2X 

This command will take a standard V3 or above 3DS file and convert it to a basic X file format retaining all 
mesh, texture, hierarchy and animation data in the conversion. This command is superseded by the LOAD 
OBJECT which automatically converts a file with the .3DS extension. This command can be used to pre- 
convert the models at compile time and speed up your game loading time. 


SYNTAX: 


3DS2X Filename, Filename 


FLUSH VIDEO MEMORY 

This command will erase all images and textures stored in Video Memory allowing automatic texture 
management to refill the memory with the textures used at that moment. Good when your scene changes 
location and the old textures are no longer required. 


SYNTAX: 
FLUSH VIDEO MEMORY 


SCALE LISTENER 

This command will adjust the relative effect of the values specified to produce 3D sound. The default value 
is 1. A value of ten would mean 3D sound values would have to be larger to produce the same decibel of 
sound. A value of 0.1 will make 3D sound more sensitive requiring only small values. 


SYNTAX: 
SCALE LISTENER Value 


OBJECT COLLISION RADIUS 
This command returns the radius of the automatic collision sphere created for all objects that are loaded or 
created at runtime. It indicates the sphere at which the object begins to apply its collision calculations. 


SYNTAX: 
Return Value = OBJECT COLLISION RADIUS (Object Number) 


LEEBAMBER 
Provides the user with a funny comment printed to the screen 


SYNTAX: 
LEEBAMBER 


MALCOLMBAMBER 
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Provides the user with a funny comment printed to the screen 


SYNTAX: 
MALCOLMBAMBER 


CHRISTOPHERBAMBER 
Provides the user with a funny comment printed to the screen 


SYNTAX: 
CHRISTOPHERBAMBER 


BREAK 

This will halt the program at the current line and take you to the CLI when in editing mode. When 
encountered in an execute, the program will quit. You can use the optional string value to return important 
information to the CLI for debugging purposes. 


SYNTAX: 
BREAK 
BREAK String Value 


WAIT KEY 
Desc: This is just like the suspend key command. 


SYNTAX: 
WAIT KEY 


CHECK LIMB LINK 
This command checks whether the specified limb has been linked in the object hierarchy or is a free floating 
limb. 


SYNTAX: 
CHECK LIMB LINK Object Number, Limb Number 
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GLOSSARY 


Area coordinates require you to specify two sets of coordinates. One coordinate represents the 
top/left of the area you wish to specify, and the second coordinate represents the bottom/right 
corner. 


2D Collision 
When two rectangular areas overlap each other, the two areas are said to be colliding. 


2D Coordinates 
Coordinates in 2D are represented by an X and Y value. Screen coordinates start at the top/left 
of the screen. The default screen size is 640 pixel wide and 480 pixel high. The first X value of 
the coordinate specifies a horizontal position that counts from left to right. The second Y value 
of the coordinate specifies a vertical position that counts from top to bottom. 


3D Accelerator 
A 3D Accelerator is a hardware device that will speed up your 3D rendering performance. 


3D Coordinates 
Coordinates in 3D are represented by an X, Y and Z value. This type of coordinate describes a 
point in 3D space. The X describes the horizontal value of the point, the Y describes the 
vertical value of the point and the Z describes how far into the distance the point is. 


3D Object Animation 
3D Objects can sometimes store animation data. 3D objects are animated by rotating, 
positioning and scaling the limbs. The animation data describes a sequence of changes that 
will be played on the 3D object. It is possible to 
append animation data to the end of an existing animation sequence. 


3D Object Collision 
When two 3D objects in 3D space overlap, they are said to be colliding. There are three types 
of collision a 3D object can use, and each depend on the shape of the area of collision. By 
default, objects use a collision area that is perfectly contoured to every polygon on the model, 
and represents the slowest form of collision. A spherical collision area can be wrapped around 
the object to provide the fastest collision detection and a rectangular bounding box is the 
third type of collision shape. 


3D Object Interpolation 
When a 3D object manually sets the new animation frame number, the visual alteration is 
instantaneous by default. It is possible, however, to slow down the rate at which the new 
frame is set. By slowing down the transition, you can create the effect of the model morphing 
seamlessly from one frame to another to smooth the joints between separate animation 
sequences. 


3D Objects 
Three dimensional models are rendered to the screen using 3D objects. The 3D objects carry 
all the information about the models position, rotation, scale, special effects, settings and 
collision detection. 


3D Sound 
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Sounds data is universal, but the manner in which it can be played can vary tremendously. 3D 
sounds can be loaded from normal sound data and played as a 3D sound by adding 
information about the position of the sound and the position of the listener at the time the 
sound is played. This is all the information you are required to provide to create 3D sound. 


3D Space 
You can imagine 3D space as the infinite void of space. Imagine that you come into this 
universe at its very center. You are able to create and position objects within this 3D space to 
create absolutely anything you can imagine. 


Ambient Light 
Ambient light is the light that is automatically introduced into any 3D scene. The intensity of 
the light can be adjusted from its current high level to absolutely zero. A second light source 
positioned high like the sun provides directional light. 3D objects whose surfaces face this 
directional light will be brighter than the ambient light level. By reducing ambient light to zero, 
the directional light becomes very distinct. 


Analogue Joystick 
An analogue joystick is a device which allows you to read analogue data from a joystick. 
Analogue is better than digital because it returns precisely how far you have moved the 
joystick handle from the center position, whereas digital only returns either True or False for a 
particular direction. 


Arrays 
Arrays are areas of memory reserved for the storage of program data. They can be accessed 
using indexes, like a filing system, to allow the program to write out ordered data and retrieve 
it at any time. 


ASCII Codes 
ASCII codes are the values that represent the identities of the characters that make up the 
text you are reading now. There are 256 ASCII codes in the standard English character set, 
and most of them are hardly ever used. The most common ASCII codes are values 65-89 that 
represent the uppercase characters 'A' to 'Z' and values 48-58 that represent characters '0' to 
'9Q'" 


AVI File Format 
The Microsoft Video One file format is used to store compressed visual and audio data. Known 
more commonly as AVI files, they are one of the types of media files used to store video clips 
and animations. 


Backdrop 
The backdrop is an automatic backdrop system when using 3D objects. The backdrop can be 
any color, textured and even scrolled to create simple horizon, skyscape and star effects. The 
backdrop can even be used as a scrolling ground terrain for games that use a birds-eye 
perspective. 


Bitmaps 
A bitmap is an area in memory were pixel data is stored. This map of pixel data will make up a 
graphic image which can be then displayed on screen. Based on the pixel bit depth, a pixel can 
take anything from 8 to 32 bits to store the color. 


Blitter Objects 
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To blit something is to paste an image to the screen. Blitter objects will repeatedly paste an 
image to the screen at a particular position. The advantage of using the blitter object is that 
you can move your image around your screen without disturbing the background. You can 
keep changing the image to create animation, or scale, stretch, flip and mirror the blitter 
object as you see fit. It is a fundamental ingredient to any 2D game. 


BMP File Format 
Bitmap files store a bitmap image of a particular width, height and depth. Bitmap files can 
either be saved as a bitmap block or compressed using run length encoding. Run length 
encoded bitmaps can only have 256 colors and are generally much smaller in size. 


Camera 
Even without using the camera, it is a critical ingredient to displaying any 3D on screen. You 
can imagine the camera as an invisible eye that peeks into your 3D world at a particular 
position. The camera can either be pointed to a coordinate in 3D space, or rotated to a 
specified angle. 


Checklists 
Checklists are an easy way to gather specific data. Each time you perform a checklist for 
particular data, it stores the results of the search in a list and numbers them incrementally. 
You can then get the size of the final list, and retrieve any item from the data you wish. 


Color Bit Depth 
A pixel can use 8, 16, 24 or 32 bits to store a color. A bit is a term used to describe the 
smallest piece of data you can store in memory. A screen that has a bit depth of 8 can only 
hold 256 different colors. A screen that has a bit depth of 16 can hold 32000 colors. A screen 
that has a bit depth of 32 can hold over 16 million different colors. 


Color Values 
Any commands that require a color value will only accept a single integer to specify the color. 
You must generate this color value using the RGB command that takes a Red, Green and Blue 
component to determine the final color. 


Conditions 
A condition is created when you compare two values using an operator. A condition will always 
be True or False. An operator can be Equal To, Greater Than, Less Than, Greater Or Equal to, 
Less Or Equal To or Not Equal To. You can 
add additional comparisons using the AND and OR statements. E.g. 
IF A=10 THEN PRINT "VARIABLE A IS EQUAL TO TEN" 
IF A>10 THEN PRINT "VARIABLE A IS GREATER THAN TEN" 
IF A>10 AND B>20 THEN PRINT "A IS GREATER THAN TEN AND B GREATER THAN 20" 


Control Devices 
Control devices can range from Force Feedback joysticks to Head Mounted Virtual Reality 
Headsets. The different types of devices are incredible, but their use can be generalized into 
analogue data and button presses. Other devices can be issued commands through the force 
feedback commands. 


Data Statements 
To include data inside your program you can use the DATA commands. Data is compiled with 
your program and accessed internally removing the need for external data files. Data can be 
stored as integer numbers, real numbers and 
strings. 
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Data Types 
There are three main types of data. Integer Numbers are whole numbers without a decimal 
point. Real Numbers use a decimal point. Strings are the third type of data and are used to 
store single characters and whole sentences. 


Digital Joystick 
A digital joystick is a device which allows you to read the direction when you move the joystick 
handle. Unlike analogue joysticks, digital joysticks do not tell you accurately how far the 
joystick handle has moved. 


Display Modes 
The choice of display modes is determined by the type of graphics card you have. The default 
display mode is 640x480x16 which creates a screen to that size and bit depth. Providing your 
card supports it, you can set the display mode to anything you wish. Eight bit display modes 
are not supported. 


DLL 

Stands for Device Link Library. These can be created using other languges such as C or C++. 
You can then call a DLL using the specific DLL commands within Dark BASIC (Enhanced version 
only). 


Expressions 
An expression is a mathematical calculation that evaluates to a value. An expression can be 
made up of commands that return a value, user functions that return a value, variables and 
immediate values. You can use brackets and mathematical operators on all values, providing 
the expression is calculable and makes sense. 


File System 
The file system is the part of the PC that handles the access, reading and writing of files on 
your drives. You should have some knowledge of drives, directories and files before using file 
system commands. You may accidentally delete something important. 


First Person Perspective 
The description given to the game genre is played through the eyes of the participating user. 
The player cannot see their body or other form, but may be able to see a sword or other 
weapon that they might be carrying. 


Fogging 
Most modern 3D cards have a fog feature that allows the world to be cloaked in a mist that 
obscures the scene the further away from the camera you look. Fog color and thickness can be 
controlled to create a variety of effects. 


Fonts 
A collection of text character sets with predefined typefaces. Two examples of fonts are 
Courier or Times New Roman. Fonts can also be altered in style, size, color and transparency. 


Force Feedback 
A type of control device that can provide force to the operator of a joystick. Force feedback 
can make a joystick move the stick in any direction and even create realistic tensions such as 
the mobility you might feel if wading through water. 


Graphics Cards 
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A part of a PC that controls the screen display. Most PCs are fitted with 2D cards as standard, 
sufficient to operate Windows smoothly. Many games require a graphics card with 3D 
acceleration to handle the demands of modern software. 


Hardware Acceleration 
Hardware Acceleration can be achieved by fitting a 3D graphics card. 


Images 
Images are no more than graphic blocks that have been grabbed from a bitmap and stored in 
memory. Images are used for fast graphics pasting, but more often are used to provide the 
animations for bobs and the textures for 3D objects. 


Integer Number 
A whole number without a decimal point. 


Jumps 
When a program finds a jump command, it leaps to a new part of the program and continues 
running from its new location. GOSUB jumps allow the program to return to the point from 
which it jumped. GOTO jumps are permanent jumps and do not allow this. All jumps require a 
label in the program to jump to. 


Keyboard 
The keys on a keyboard can be divided into two types. Normal keys and control keys. Normal 
keys are the letters, numbers and symbols you associate with printable characters. Control 
keys are often indicated as the shaded keys on the keyboard. These keys use different 
commands to detect their use as very often control keys are used in combination with normal 
keys. 


Label 
A label is a plain English marker that is used by the program to make a jump. Labels are most 
often used to declare a subroutine that must always be headed by a label, or used to declare 
the start of a set of DATA statements. 


Loading Media 
Media files can be any of the BMP, AVI, WAV, MID, X or TXT type. Media files are often used 
to store data that has been retrieved or prepared externally and represents the visuals and 
audio of your software. When you load media files, an area of memory is used to store the 
data and it will remain their until you either quit the program or delete it. 


Loops 
A program is run by executing the first command in the program, then moving to the next 
one. This process repeats until there are no more commands to execute. A program loop takes 
this pointer and returns it to an earlier part of the program. When such a loop occurs, the 
program continually re-executes the same section of commands until the loop is broken. There 
are several types of program loop, but all share the same process of looping until the loop is 
broken. 


Matrix Grids 
A Matrix can be described as a grid of tiles that can be raised and lowered to create 
landscapes. You can also texture, rotate and scroll the matrix to create a variety of realistic 
landscape scenes and effects. 


Memory Block 
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An area of memory that’s laid out in a set format for easy storing and manipulation of game 
specific data (e.g. sound, music, mesh, images etc). 


Meshes 
A mesh is a wireframe description of a 3D shape. 


MID File Format 
MIDI is a format that allows a piece of music to be recorded and played back. The advantage 
of using MIDI is that all the instrument effects are stored on your sound card and so MIDI files 
are notoriously small. 


Mouse Pointer 
The arrow that moves around the screen when you move the mouse is the mouse pointer. You 
can retrieve the 2D coordinate of a mouse pointer and detect for mouse button clicks very 
easily. 


Multiplayer 
Term used to describe a game that involved 2 or more players. Multiplayer games can exist in 
a single DarkBASIC file or in a Client-Server based system. 


Music 
Music is played using the MIDI sequencer that takes advantage of any advanced sound card 
technology. 


PC System 
It is important to realize that if you wish your software to be used on other machines that your 
software will not fail. It is always important to check for the existence of a mode or device 
before presuming you can use it. Checking the memory of a machine can reveal how much 
media you can afford to load in at any one time. 


Real Number 
These numbers use decimal points to specify floating point values. Real variables are 
recognized for having a hash(#) as the last character. 


Refreshing The Screen 
Any real-time software requires a good screen refresh rate to present a smooth professional 
presentation. Screen refresh is handled automatically by default to give beginners as little to 
worry about as possible. Using the SYNC ON command however, the user can take control of 
updating the screen and increase the efficiency of the refresh. 


Remarks 
Remarks are used to make comments within the program, providing a plain English description 
of what a particular piece of code does. There are many ways to implement remarks, including 
the time honoured REM statement. 


Screens 
A screen is defined by the current display mode. The default display mode is 640 pixels wide, 
480 pixels high and has a bit depth of 16. This means your visible screen is 640x480. If you 
change the display mode you change the screen. The screen itself uses bitmap zero to draw 
to. Anything you draw to bitmap zero will appear on the visible screen. You only have one 
screen at any one time, but you are able to store bitmaps off-screen and use bitmap zero as 
the work area for your software. 
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Sounds 
Sounds are played using WAV data. You are able to alter a sounds speed, volume and 
panning. Panning is the effect of moving a sound from one speaker to another. You can also 
generate true 3D sounds by providing 3D information for the sound. You are able to play many 
sounds simultaneously, but it is recommended to keep to 4-6 for performance reasons. 


Strings 
Strings are used to store single characters, words and whole sentences. They are recognized 
by enclosing the text you wish to treat as a string in speech marks. String variables are 
recognized for having a dollar($) sign as the last character. 


System Memory 
The main RAM chips plugged into your motherboard represent the total amount of system 
memory in your machine. Do not confuse this with available total memory which takes into 
account memory used by Windows, other applications and your software. 


Text Settings 
At any time, the text settings hold data that determines how text printed by the TEXT or 
CENTER TEXT commands will be output to the screen. Text settings hold typeface, style, size, 
color and transparency information. 


Textures 
Textures are used to paint the surfaces of 3D objects. You can apply your own texture to a 3D 
object by grabbing an image from a bitmap and simply texturing it. Textures cannot be greater 
than 256x256 is size. The texture size must be divisible by two. Some graphics cards will not 
render the texture if the width and height are different sizes. 


Time Format 
Commands that require a time value must be given a value measured in milliseconds where 
1000 units represent 1 second of time. 


Third Person Perspective 
The description given to the game genre is played through the eyes of a remote camera that 
tracks and follows the participating user. The player can see their game persona as it moves 
around the game world, as though seen by a third person. 


TXT File Format 
A simple ASCII data file. You are able to load TXT files by declaring a single dimension string 
array and loading the TXT file as an array. You can then access the array to get at the text 
data. 


User Defined Functions 
In addition to the commands that are built into the language, you are able to add your own by 
declaring a function somewhere in your program. You can even build your own custom 
commands to speed up your developments even further. 


Video Memory 
The RAM built into your graphics card represents the total amount of video memory in your 
machine. It is not possible to determine how much video memory is being used at any one 
time due to the dynamic nature of Dark Basic. 


Visible Screen 
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The visible screen uses the contents of bitmap zero as the work area. Drawing to bitmap zero, 
which is the default, is in effect drawing to the screen. Bitmap zero cannot be deleted. If the 
program switches the display mode, the screen also changes to the dimensions of the display 
mode. 


WAV File Format 
The WAV file format has been around for over a decade and is an uncompressed data sample 
of a sound effect. By playing the WAVE data through the sound card, the sound reproduced 
can be literally anything. 


Wireframe 
A wireframe is a method of displaying a shape, matrix or 3D object without filling it in with 
shades or textures. Wireframe displays are useful for measuring polygon complexity and a few 
parlour tricks. The downside to using wireframe is that the shapes are clipped when they leave 
the screen, allowing the user to see the triangle divisions taking place that may not be 
desirable in a finished piece of software. 


X File Format 
The XOF file format is the primary format used by DirectX developers to load 3D data quickly. 
It is not the most common file format amongst modellers and 3D animators, but converters 
are available to convert the more common 3DS, LWO and COB files over. 
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Command Index 


CAMERA ANGLE X(), 115 
# CAMERA ANGLE Y(), 115 
CAMERA ANGLE Z(), 115 
HNC LEE S? CAMERA POSITION X(), 115 
CAMERA POSITION Y(), 115 


3 CAMERA POSITION Z(), 115 
3DBLIT AVAILABLE(), 110 CASE, 36 
3DS2X, 144 CASE DEFAULT, 36 
CD, 51 
A CENTER TEXT, 63 
CHANGE MESH, 106 
ABS(), 58 CHANGE MESH FROM MEMBLOCK, 136 
ACOS(), 59 CHECK DISPLAY MODE(), 67 
ADD LIMB, 103 CHECKLIST QUANTITY(), 127 
ALPHABLENDING AVAILABLE(), 110 CHECKLIST STRINGS(), 127 
ALWAYS ACTIVE OFF, 129 CHECKLIST VALUE AQ), 127 
ALWAYS ACTIVE ON, 129 CHECKLIST VALUE BQ), 127 
ANIMATION EXIST(), 85 CHECKLIST VALUE C(), 127 
ANIMATION HEIGHT(), 85 CHECKLIST VALUE D0), 127 
ANIMATION LOOPED(), 85 CHRS(), 65 
ANIMATION PAUSED(), 85 CHRISTOPHERBAMBER, 145 
ANIMATION PLAYING(), 85 CIRCLE, 61 
ANIMATION POSITION X(), 85 CLS(), 40 
ANIMATION POSITION Y(), 85 CLEAR ALL OBJECT KEYFRAMES, 95 
ANIMATION WIDTHO), 85 CLEAR CAMERA VIEW, 113 
APPEND OBJECT, 89 CLEAR ENTRY BUFFER, 57 
APPEND OBJECT ANIMATION, 94 CLEAR OBJECT KEYERAME, 95 
APPNAMES(), 130 CLONE SOUND, 77 
ASC(), 64 CLOSE FILE, 53 
ASIN(), 59 CLS, 61 
ATAN(), 59 COLOR AMBIENT LIGHT, 118 
ATANFULLO), 59 COLOR BACKDROP, 108 
ATTACH OBJECT TO STATIC, 97 COLOR LIGHT(), 117 
AUTOCAM OFF, 114 COLOR LIMB, 104 
AUTOCAM ON, 114 COLOR OBJECT, 90 
CONTROL DEVICE NAMES(), 48 
B CONTROL DEVICE X(), 48 
BACKDROP OFF, 108 CONTROL DEVICE Y(), 48 
BACKDROP ON. 108 CONTROL DEVICE Z(), 48 
BINS(), 64 CONTROLKEY(), 41 
BITMAP DEPTH(), 71 COPY BITMAP, 69 
BITMAP EXISTS(), 70 COPY FILE, 52 
BITMAP FLIPPED(), 71 COPY MEMBLOCK, 132 
BITMAP HEIGHT(), 71 COS(), 59 
BITMAP MIRRORED(), 71 CREATE BITMAP, 69 
BITMAP WIDTH(, 70 CREATE NET GAME, 138 
BLUR BITMAP, 70 CREATE NET PLAYER, 140 
BOX, 61 CURRENT BITMAP(), 70 
BREAK, 145 CURRENT GRAPHICS CARD$(), 128 
CURVEANGLE(), 109 
Cc CURVEVALUE(), 109 


CALL DLL, 131 
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D 


DATA, 37 

DEC, 58 

DELETE ANIMATION, 85 
DELETE BITMAP, 70 

DELETE DIRECTORY, 52 
DELETE DLL, 130 

DELETE FILE, 52 

DELETE IMAGE, 74 

DELETE LIGHT, 116 

DELETE MATRIX, 124 
DELETE MEMBLOCK, 132 
DELETE MESH, 106 

DELETE MUSIC, 82 

DELETE OBJECT, 87 

DELETE OBJECT COLLISION BOX, 100 
DELETE SOUND, 78 

DELETE SPRITE, 74 

DELETE STATIC OBJECTS, 96 
DETACH OBJECT FROM STATIC, 97 
DIM, 38 

DIR, 51 

DISABLE ESCAPEKEY, 128 
DISABLE OBJECT ZDEPTH, 92 
DISABLE STATIC OCCLUSION, 96 
DISABLE SYSTEMKEYS, 130 
DISABLE TNL, 126 

DLL CALL EXIST, 131 

DLL EXIST, 131 

DO LOOP, 34 

DOT, 61 

DOWNKEY(), 41 

DRAW TO BACK, 108 

DRAW TO FRONT, 108 
DRIVELIST, 51 


E 


ELLIPSE, 62 

EMPTY CHECKLIST, 126 
EMULATION MODE(), 128 
NABLE ESCAPEKEY, 128 
NABLE OBJECT ZDEPTH, 92 
NABLE STATIC OCCLUSION, 96 
NABLE SYSTEMKEYS, 130 
NABLE TNL, 126 

ND, 35 

NDCASE, 36 

NDFUNCTION, 35 
NDSELECT, 36 

NTRYS, 57 

ESCAPEKEY(), 42 

EXECUTE FILE, 52 

EXIT, 34 

EXIT PROMPT, 128 
EXITFUNCTION, 35 


epmesiesmesmesimesiesmesmesmes| 
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EXP(), 59 


F 


FADE BITMAP, 70 

FADE OBJECT, 91 

FILE END(), 56 

FILE EXIST(), 56 

FILE OPEN(), 56 

FILE SIZE(), 56 

FILL MATRIX, 121 
FILTERING AVAILABLE(), 110 
FIND FIRST, 51 

FIND NEXT, 51 

FIX OBJECT PIVOT, 98 
FLIP BITMAP, 69 

FLIP SPRITE, 73 

FLUSH VIDEO MEMORY, 144 
FOG AVAILABLE(), 110 
FOG COLOR, 118 

FOG DISTANCE, 118 

FOG OFF, 118 

FOG ON, 118 

FOR NEXT, 33 

FORCE ANGLE, 45 

FORCE AUTO CENTER OFF, 46 
FORCE AUTO CENTER ON, 45 
FORCE CHAINSAW, 45 
FORCE DOWN, 44 

FORCE IMPACT, 45 

FORCE LEFT, 44 

FORCE NO EFFECT, 45 
FORCE RIGHT, 44 

FORCE SHOOT, 45 

FORCE UP, 44 

FORCE WATER EFFECT, 45 
FREE NET GAME, 139 
FREE NET PLAYER, 140 
FTP CONNECT, 48 

FTP DELETE FILE, 49 

FTP DISCONNECT, 49 

FTP FIND FIRST, 49 

FTP FIND NEXT, 49 

FTP GET FILE, 49 

FTP PROCEED, 49 

FTP PUT FILE, 49 

FTP SET DIR, 48 

FTP TERMINATE, 49 
FUNCTION, 34 


G 


GET BACKBUFFER DEPTH, 137 
GET BACKBUFFER HEIGHT, 136 
GET BACKBUFFER PITCH, 137 
GET BACKBUFFER PTR, 136 
GET BACKBUFFER WIDTH, 136 


GET CLIPBOARDS(), 57 

GET DATES(), 40 

GET DIRS), 55 

GET FILE DATES(), 56 

GET FILE NAMES(), 56 

GET FILE TYPE(), 56 

GET FTP DIRS(), 50 

GET FTP ERRORS(), 50 

GET FTP FAILURE(), 50 

GET FTP FILE NAMES(), 50 

GET FTP FILE SIZE(), 50 

GET FTP FILE TYPE(), 50 

GET FTP PROGRESS(), 50 

GET FTP STATUS(), 50 

GET GROUND HEIGHTO(), 125 
GET IMAGE, 74 

GET MATRIX HEIGHT(), 124 
GET MEMBLOCK PTR, 133 

GET MEMBLOCK SIZE, 133 

GET NET MESSAGE, 142 

GET OBJECT COLLISION X(), 102 
GET OBJECT COLLISION Y(), 102 
GET OBJECT COLLISION Z(), 102 
GET REGISTRY, 57 

GET SOUND PAN(), 80 

GET SOUND SPEED(), 80 

GET SOUND VOLUME(), 80 

GET STATIC COLLISION HIT(), 97 
GET STATIC COLLISION X(), 97 
GET STATIC COLLISION Y(), 97 
GET STATIC COLLISION Z(), 97 
GET TIMES(), 40 

GHOST MATRIX OFF, 124 
GHOST MATRIX ON, 123 

GHOST OBJECT OFF, 91 

GHOST OBJECT ON, 91 

GLUE OBJECT TO LIMB, 91 
GOSUB, 35 

GOTO, 35 


H 


HCOS(), 60 

HEXS(), 65 

HIDE ALL SPRITES, 73 
HIDE LIGHT, 117 
HIDE LIMB, 102 
HIDE MOUSE, 42 
HIDE OBJECT, 89 
HIDE SPRITE, 73 
HIDE WINDOW, 128 
HSIN(), 60 

HTAN(O, 60 


I 
IF ENDIF, 33 
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IF THEN, 33 
IMAGE EXIST(), 75 
INC, 58 

INK, 61 

INKEYS(), 41 
INPUT, 41 

INT(), 58 


J 


JOIN NET GAME, 139 
JOYSTICK DOWN(), 47 
JOYSTICK FIRE A(), 46 
JOYSTICK FIRE B(), 46 
JOYSTICK FIRE C(), 46 
JOYSTICK FIRE DO), 46 
JOYSTICK HAT ANGLE(), 48 
JOYSTICK LEFT(), 47 
JOYSTICK RIGHT(), 47 
JOYSTICK SLIDER AQ), 47 
JOYSTICK SLIDER B(), 47 
JOYSTICK SLIDER C(), 47 
JOYSTICK SLIDER DQ), 47 
JOYSTICK TWIST X(), 47 
JOYSTICK TWIST YO), 48 
JOYSTICK TWIST ZO), 48 
JOYSTICK UP(), 47 
JOYSTICK X(), 46 
JOYSTICK Y(), 46 
JOYSTICK Z(), 46 


K 
KEYSTATE(), 42 


L 


LEEBAMBER, 144 
LEFTS(), 65 

LEFTKEY(), 41 

LEN(), 65 

LIGHT DIRECTION X(), 119 
LIGHT DIRECTION Y(), 119 
LIGHT DIRECTION Z(), 119 
LIGHT EXIST(), 119 

LIGHT POSITION X(), 119 
LIGHT POSITION Y(), 119 
LIGHT POSITION Z( ), 119 
LIGHT RANGE(, 119 
LIGHT TYPE(), 119 

LIGHT VISIBLE(, 119 
LIMB ANGLE X(), 105 
LIMB ANGLE Y(), 105 
LIMB ANGLE Z(), 105 
LIMB DIRECTION Y(), 106 
LIMB EXIST(), 104 

LIMB OFFSET X(), 104 


LIMB OFFSET Y(), 104 
LIMB POSITION X(), 105 
LIMB POSITION Y(), 105 
LIMB POSITION Z(), 105 
LIMB TEXTURE NAME(), 106 
LIMB TEXTURE(), 106 
LIMB VISIBLE(), 106 

LINE, 61 

LINK LIMB, 103 

LISTENER ANGLE X(), 81 
LISTENER ANGLE Y(), 81 
LISTENER ANGLE Z(), 81 
LISTENER POSITION X(), 81 
LISTENER POSITION Y(), 81 
LISTENER POSITION Z(), 81 
LOAD 3DSOUND, 77 

LOAD ANIMATION, 84 
LOAD ARRAY, 38 

LOAD BITMAP, 69 

LOAD CDMUSIC, 82 

LOAD DLL, 130 

LOAD IMAGE, 74 

LOAD MESH, 106 

LOAD MUSIC, 82 

LOAD OBJECT, 87 

LOAD SOUND, 77 

LOAD STATIC OBJECTS, 97 
LOCK BACKBUFFER, 136 
LOCK OBJECT OFF, 92 
LOCK OBJECT ON, 92 
LOOP ANIMATION, 84 
LOOP MUSIC, 82 

LOOP OBJECT, 89 

LOOP SOUND, 77 
LOWERS(), 65 


MAKE BITMAP FROM MEMBLOCK, 134 
MAKE DIRECTORY, 52 

MAKE FILE, 52 

MAKE IMAGE FROM MEMBLOCK, 134 
MAKE LIGHT, 116 
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